Hoe u de systeemfirmware van SR635 en SR655 kunt updaten met behulp van de BMC Redfish REST API

Dit artikel is een machinevertaling. Klik hier om de originele Engelse versie te bekijken.

Beschrijving

De AMD 1P Redfish Server is gebaseerd op het AMI MegaRAC® Redfish Technology Package V1.7 (volgt DSP0266 1.7.0-specificatie en Redfish Schema 2019.1). Om OEM-API's toe te voegen, gebruikt Redfish RESTful-interfacesemantiek en JSON-bronpayloads om systeembeheer uit te voeren via webgebaseerde protocollen.

Dit artikel introduceert de procedure die wordt gebruikt om systeemfirmware bij te werken met behulp van de BMC Redfish REST API.

In dit artikel worden de volgende HTTP-methoden gebruikt:

GET: leesverzoek – wordt gebruikt om een specifieke bron of verzameling aan te vragen om gegevens te controleren
POST: actieverzoek – gebruikt om bewerkingen te initiëren of bronnen te creëren

Toepasselijke systemen

SR635, SR655

Vereisten

Redfish-clients moeten op uw werkstation of laptop worden geïnstalleerd.
- Roodbaars klant
  - Chrome: Postman, Talend API-tester
  - Firefox: RESTClient
Het werkstation of de laptop moet directe netwerktoegang hebben tot de BMC op de doelserver.

Procedures

Download het juiste firmwarepakket voor uw machine vanaf de ondersteuningspagina Lenovo .
Pak de bestanden uit en kopieer de inhoud naar een opgegeven map.

Informatie over de geïnstalleerde firmware verkrijgen

Om toegang te krijgen tot de eigenschappen in de firmware-inventarisverzameling, opent u Postman, selecteert u de GET- methode ① en voert u vervolgens de volgende gevraagde URL in ② : https:// BMCIP /redfish/v1/UpdateService/FirmwareInventory

Op het tabblad Autorisatie selecteert u Basisverificatie in het menu Type ③ en voert u vervolgens de BMC-referenties in ④ . Klik op Verzenden ⑤ .

Let op: Deze autorisatiestap is vereist voor elk verzoek.
Reactie voorbeeld
Als het vorige verzoek succesvol is, wordt een berichttekst geretourneerd die lijkt op het volgende:

 {
    
"@odata.context" : "/redfish/v1/$metadata#SoftwareInventoryCollection.SoftwareInventoryCollection" ,
    
"@odata.etag" : "\"1577837046\"" ,
    
"@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory" ,
    
"@odata.type" : "#SoftwareInventoryCollection.SoftwareInventoryCollection" ,
    
"Description" : "Verzameling van firmware-inventarisatiebronnen die beschikbaar zijn voor de UpdateService" ,
    
"Leden" : [
    
{
    
"@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory/LXPMLinuxDriver1" },
    
{
    
"@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory/PSU2" },
    
{
    
"@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory/LXPMWindowsDriver1" },
    
{
    
"@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory/BMC-Primary" },
    
{
    
"@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory/BMC-Backup" },
    
{
    
"@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory/LXPM" },
    
{
    
"@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory/UEFI" },
    
{
    
"@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory/PSU1" }
    
],
    
"Leden@odata.count" : 8 ,
    
"Naam" : "Firmware-inventarisverzameling" }

Zoek in de uitvoer van de ledenlijst het systeemfirmware-eindpunt dat u wilt opvragen, bijvoorbeeld /redfish/v1/UpdateService/FirmwareInventory/UEFI . Voer het in het URL-veld in om de UEFI-informatie op te halen.

{
  
    "@odata.context" : "/redfish/v1/$metadata#UpdateService.UpdateService" ,
  
    "@odata.etag" : "\"1577837046\"" ,
  
    "@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory/UEFI" ,
  
    "@odata.type" : "#SoftwareInventory.v1_2_2.SoftwareInventory" ,
  
    "Id" : "UEFI" ,
  
    "Naam" : "UEFI-firmware" ,
  
    "GerelateerdItem" : [
  
{
  
            "@odata.id" : "/redfish/v1/Systems/Self"
  
},
  
{
  
            "@odata.id" : "/redfish/v1/Systems/1"
  
}
  
],
  
    "RelatedItem@odata.count" : 2 ,
  
    "SoftwareId" : "CFE118K" ,
   
    "Toestand" : {
   
        "Gezondheid" : "OK" ,
   
        "Status" : "Ingeschakeld"
   
},
   
    "Bij te werken" : waar ,
   
    "Versie" : "5.10"
  
}

In de hierboven weergegeven antwoordgegevens is de geïnstalleerde UEFI-versie 5.10 en is de software-ID CFE118K .

UEFI-updates

Selecteer de POST- methode en voer vervolgens de volgende gevraagde URL in: https:// BMCIP /redfish/v1/UpdateService/upload
Op het tabblad Body ① voor de POST-actie selecteert u form-data ② , stelt u de KEY-naam in op UpdateFile ③ en wijzigt u het KEY-type in File ④ .

POSTlichaam

Selecteer in het waardegedeelte de firmware-image die u wilt bijwerken.

bestand

Open een teksteditor zoals Notepad++ om een parameters.json JSON-bestand te maken met de volgende inhoud:

 { "Doelen": [ "/redfish/v1/Managers/Self" ] }

parameters

Maak nog een oem_parameters.json JSON-bestand met de volgende inhoud:

 {
      "FlashType:UEFIUpdate",
      "UploadSelector": "Standaard"                    
}

oem_parameters

Voer UpdateParameters in als KEY-naam, wijzig het KEY-type in File en selecteer vervolgens het parameters.json -bestand dat u in stap 4 hebt gemaakt.
Voer OemParameters in als een andere KEY-naam, wijzig het KEY-type in File en selecteer vervolgens het bestand oem_parameters.json dat u in stap 5 hebt gemaakt.
Klik op Verzenden .

UEFI-update

Als het verzoek succesvol is, wordt de responscodestatus 202 Geaccepteerd weergegeven. De berichttekst zal lijken op het volgende voorbeeld:

202 geaccepteerd

UEFI-updatestatus

In het bovenstaande antwoordvoorbeeld is /redfish/v1/TaskService/Tasks/1989 de nieuwe taak die zojuist is gemaakt. U kunt de Get- methode gebruiken om de updatestatus op te vragen met de taak-ID.

Verzoek-URL

https:// BMCIP /redfish/v1/TaskService/Task/ ID

Reactie voorbeeld

BIOS-status opvragen

vraag de biosstatus op2

Krachtacties

Start de server opnieuw op en voer de firmware-inventarisatie opnieuw uit. De BIOS versie is bijgewerkt.

U kunt ook de POST- methode gebruiken om een systeemreset uit te voeren.

Aanvraag-URL

https:// BMCIP /redfish/v1/System/Self/Actions/ComputerSystem.Reset

Gewenste inhoud van de POST-actie:

{"ResetType:Herstart forceren"}

Reactie voorbeeld

Als de actie succesvol was, wordt antwoordstatus 202 geretourneerd met de volgende antwoordtekst:

 {
  
    "@odata.context" : "/redfish/v1/$metadata#Task. Task(TaskState,Description,Name,Id)" ,
  
    "@odata.id" : "/redfish/v1/TaskService/Tasks/1" ,
  
    "@odata.type" : "#Task.v1_2_0.Task" ,
  
    "Beschrijving" : "Taak voor het resetten van de computer" ,
  
    "Id" : " 1 " ,
  
    "Naam" : "Computer opnieuw instellen" ,
  
    "Taakstatus" : "Nieuw"
  
}

BMC-updates

Selecteer de POST-methode en voer vervolgens de volgende gevraagde URL in:

http:// BMCIP /redfish/v1/UpdateService/upload

Op het tabblad Body ① voor de POST-actie selecteert u form-data ② , stelt u de KEY-naam in op UpdateFile ③ en wijzigt u het KEY-type in File ④ .

POSTlichaam

Selecteer in het waardegedeelte de firmware-image die u wilt bijwerken.

bestand

Open een broncode-editor zoals Notepad++ om een parameters.json JSON-bestand te maken met de volgende inhoud:

 { "Doelen": [ "/redfish/v1/Managers/Self" ] }

parameters

Maak nog een oem_parameters.json JSON-bestand met de volgende inhoud:

 {
      "FlashType:HPMFwUpdate",
      "UploadSelector": "Standaard"                     
}

parameters_bmc

Voer UpdateParameters in als KEY-naam, wijzig het KEY-type in File en selecteer vervolgens het parameters.json -bestand dat u in stap 4 hebt gemaakt.
Voer OemParameters in als een andere KEY-naam, wijzig het KEY-type in File en selecteer vervolgens het bestand oem_parameters.json dat u in stap 5 hebt gemaakt.
Klik op Verzenden .

BMC-update

Als het verzoek succesvol is, wordt de responscodestatus 202 Geaccepteerd weergegeven. De berichttekst zal lijken op het volgende voorbeeld:

BMC_taak

In het bovenstaande antwoordvoorbeeld is /redfish/v1/TaskService/Tasks/1991 de nieuwe taak die zojuist is gemaakt. U kunt de Get- methode gebruiken om de updatestatus op te vragen met de taak-ID.

Verzoek-URL

https:// BMCIP /redfish/v1/TaskService/Task/ ID

Reactie voorbeeld

BMC_Update-status

Wanneer de taakstatus voltooid is en de ThinkSystem System Manager (BMC GUI) toegankelijk is, wordt de BMC-versie bijgewerkt.

Video

Extra informatie

Gerelateerd artikel

Document-ID:HT511480

Oorspronkelijke publicatiedatum:11/19/2020

Laatste gewijzigde datum:03/30/2024