So aktualisieren Sie die Systemfirmware SR635 und SR655 mithilfe der BMC Redfish REST API

Dieser Beitrag wurde maschinell übersetzt. Für die englische Originalversion bitte hier klicken.

Beschreibung

Der AMD 1P Redfish Server basiert auf dem AMI MegaRAC® Redfish Technology Package V1.7 (entspricht der Spezifikation DSP0266 1.7.0 und dem Redfish Schema 2019.1). Um OEM-APIs hinzuzufügen, nutzt Redfish die RESTful-Schnittstellensemantik und JSON-Ressourcennutzlasten, um die Systemverwaltung über webbasierte Protokolle durchzuführen.

In diesem Artikel wird das Verfahren zum Aktualisieren der Systemfirmware mithilfe der BMC Redfish REST API vorgestellt.

In diesem Artikel werden die folgenden HTTP-Methoden verwendet:

GET: Leseanforderung – wird verwendet, um eine bestimmte Ressource oder Sammlung anzufordern, um Daten zu überprüfen
POST: Aktionsanforderung – wird zum Initiieren von Vorgängen oder zum Erstellen von Ressourcen verwendet

Anwendbare Systeme

SR635, SR655

Voraussetzungen

Redfish-Clients müssen auf Ihrer Workstation oder Ihrem Laptop installiert sein.
- Redfish-Kunde
  - Chrome: Postman, Talend API-Tester
  - Firefox: RESTClient
Die Workstation oder der Laptop muss direkten Netzwerkzugriff auf den BMC auf dem Zielserver haben.

Verfahren

Laden Sie das entsprechende Firmware-Paket für Ihr Gerät von der Lenovo Support- Seite herunter.
Entpacken Sie die Dateien und kopieren Sie den Inhalt in einen angegebenen Ordner.

So erhalten Sie die Informationen zur installierten Firmware

Um auf die Eigenschaften in der Firmware-Inventarsammlung zuzugreifen, öffnen Sie Postman, wählen Sie die GET- Methode ① aus und geben Sie dann die folgende angeforderte URL ② ein: https:// BMCIP /redfish/v1/UpdateService/FirmwareInventory

Wählen Sie auf der Registerkarte „Autorisierung“ im Menü „Typ“ die Option „Basic Auth“ aus ③ und geben Sie dann die BMC-Anmeldeinformationen ein ④ . Klicken Sie auf Senden ⑤ .
Firmware-Inventur

Hinweis: Dieser Autorisierungsschritt ist für jede Anfrage erforderlich.
Antwortbeispiel
Wenn die vorherige Anfrage erfolgreich ist, wird ein Nachrichtentext ähnlich dem folgenden zurückgegeben:

 {
    
„@odata.context“ : „/redfish/v1/$metadata#SoftwareInventoryCollection.SoftwareInventoryCollection“ ,
    
"@odata.etag" : "\"1577837046\"" ,
    
„@odata.id“ : „/redfish/v1/UpdateService/FirmwareInventory“ ,
    
„@odata.type“ : „#SoftwareInventoryCollection.SoftwareInventoryCollection“ ,
    
„Beschreibung“ : „Sammlung von Firmware-Inventarressourcen, die für den UpdateService verfügbar sind“ ,
    
„Mitglieder“ : [
    
{
    
"@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“ }
    
],
    
„Members@odata.count“ : 8 ,
    
„Name“ : „Firmware-Inventarsammlung“ }

Suchen Sie in der Ausgabe der Mitgliederliste den System-Firmware-Endpunkt, den Sie abfragen möchten – zum Beispiel /redfish/v1/UpdateService/FirmwareInventory/UEFI . Geben Sie diese in das URL-Feld ein, um die UEFI-Informationen zu erhalten.

{
  
    "@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“ ,
  
    „Name“ : „UEFI-Firmware“ ,
  
    „RelatedItem“ : [
  
{
  
            „@odata.id“ : „/redfish/v1/Systems/Self“
  
},
  
{
  
            „@odata.id“ : „/redfish/v1/Systems/1“
  
}
  
],
  
    "RelatedItem@odata.count" : 2 ,
  
    „SoftwareId“ : „CFE118K“ ,
   
    „Status“ : {
   
        „Gesundheit“ : „OK“ ,
   
        „Status“ : „Aktiviert“
   
},
   
    „Aktualisierbar“ : wahr ,
   
    „Version“ : „5.10“
  
}

In den oben gezeigten Antwortdaten ist die installierte UEFI-Version 5.10 und die Software-ID ist CFE118K .

UEFI-Updates

Wählen Sie die POST- Methode aus und geben Sie dann die folgende angeforderte URL ein: https:// BMCIP /redfish/v1/UpdateService/upload
Wählen Sie auf der Registerkarte „Body“ ① für die POST-Aktion form-data ② aus, legen Sie den KEY-Namen auf UpdateFile ③ fest und ändern Sie den KEY-Typ in File ④ .

POSTbody

Wählen Sie im Wertbereich das Firmware-Image aus, das Sie aktualisieren möchten.

Datei

Öffnen Sie einen Texteditor wie Notepad++, um eine JSON-Datei „parameters.json“ mit folgendem Inhalt zu erstellen:

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

Parameter

Erstellen Sie eine weitere JSON-Datei oem_parameters.json mit folgendem Inhalt:

 {
      „FlashType“: „UEFIUpdate“,
      „UploadSelector“: „Standard“                    
}

oem_parameters

Geben Sie „UpdateParameters“ als KEY-Namen ein, ändern Sie den KEY-Typ in „File “ und wählen Sie dann die Datei „parameters.json“ aus, die Sie in Schritt 4 erstellt haben.
Geben Sie „OemParameters“ als weiteren KEY-Namen ein, ändern Sie den KEY-Typ in „File “ und wählen Sie dann die Datei „oem_parameters.json “ aus, die Sie in Schritt 5 erstellt haben.
Klicken Sie auf Senden .

UEFI-Update

Wenn die Anfrage erfolgreich ist, wird der Antwortcode-Status 202 Akzeptiert angezeigt. Der Nachrichtentext ähnelt dem folgenden Beispiel:

202 angenommen

UEFI-Update-Status

Im obigen Antwortbeispiel ist /redfish/v1/TaskService/Tasks/1989 die neue Aufgabe, die gerade erstellt wurde. Mit der Get- Methode können Sie den Update-Status mit der Task-ID abfragen.

URL anfordern

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

Antwortbeispiel

BIOS-Status abfragen

BIOS-Status abfragen2

Machtaktionen

Starten Sie den Server neu und führen Sie die Firmware-Inventur erneut durch. Die BIOS Version wurde aktualisiert.

Sie können auch die POST- Methode verwenden, um einen System-Reset durchzuführen.

Anfrage-URL

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

Angeforderter Text der POST-Aktion:

{"ResetType": "ForceRestart"}

Antwortbeispiel

Wenn die Aktion erfolgreich war, wird der Antwortstatus 202 mit dem folgenden Antworttext zurückgegeben:

 {
  
    „@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“ ,
  
    „Beschreibung“ : „Aufgabe zum Zurücksetzen des Computers“ ,
  
    „ID“ : „ 1 “ ,
  
    „Name“ : „Computer zurücksetzen“ ,
  
    „TaskState“ : „Neu“
  
}

BMC-Updates

Wählen Sie die POST-Methode aus und geben Sie dann die folgende angeforderte URL ein:

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

Wählen Sie auf der Registerkarte „Body“ ① für die POST-Aktion form-data ② aus, legen Sie den KEY-Namen auf UpdateFile ③ fest und ändern Sie den KEY-Typ in File ④ .

POSTbody

Wählen Sie im Wertbereich das Firmware-Image aus, das Sie aktualisieren möchten.

Datei

Öffnen Sie einen Quellcode-Editor wie Notepad++, um eine JSON-Datei „parameters.json“ mit folgendem Inhalt zu erstellen:

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

Parameter

Erstellen Sie eine weitere JSON-Datei oem_parameters.json mit folgendem Inhalt:

 {
      „FlashType“: „HPMFwUpdate“,
      „UploadSelector“: „Standard“                     
}

Parameter_bmc

Geben Sie „UpdateParameters“ als KEY-Namen ein, ändern Sie den KEY-Typ in „File “ und wählen Sie dann die Datei „parameters.json“ aus, die Sie in Schritt 4 erstellt haben.
Geben Sie „OemParameters“ als weiteren KEY-Namen ein, ändern Sie den KEY-Typ in „File “ und wählen Sie dann die Datei „oem_parameters.json “ aus, die Sie in Schritt 5 erstellt haben.
Klicken Sie auf Senden .

BMC-Update

Wenn die Anfrage erfolgreich ist, wird der Antwortcode-Status 202 Akzeptiert angezeigt. Der Nachrichtentext ähnelt dem folgenden Beispiel:

BMC_task

Im obigen Antwortbeispiel ist /redfish/v1/TaskService/Tasks/1991 die neue Aufgabe, die gerade erstellt wurde. Mit der Get- Methode können Sie den Update-Status mit der Task-ID abfragen.

URL anfordern

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

Antwortbeispiel

BMC_Update-Status

Wenn der Aufgabenstatus abgeschlossen ist und auf den ThinkSystem System Manager (BMC GUI) zugegriffen werden kann, wird die BMC-Version aktualisiert.