Opis

Serwer AMD 1P Redfish jest oparty na pakiecie technologii AMI MegaRAC® Redfish Technology Package V1.7 (zgodnym ze specyfikacją DSP0266 1.7.0 i schematem Redfish 2019.1). Aby dodać interfejsy API OEM, firma Redfish wykorzystuje semantykę interfejsu RESTful i ładunki zasobów JSON w celu zarządzania systemem za pośrednictwem protokołów internetowych.

W tym artykule przedstawiono procedurę aktualizacji oprogramowania systemowego przy użyciu interfejsu API REST BMC Redfish.

W tym artykule zostaną użyte następujące metody HTTP:

• GET: żądanie odczytu – używane do żądania określonego zasobu lub kolekcji w celu sprawdzenia danych
• POST: żądanie akcji – używane do inicjowania operacji lub tworzenia zasobów

Obowiązujące systemy

SR635, SR655

Warunki wstępne

• Klienci Redfish muszą być zainstalowani na stacji roboczej lub laptopie.
  • Klient karmazyna
    • Chrome: Postman, Tester API Talend
    • Firefox: Klient REST
• Stacja robocza lub laptop musi mieć bezpośredni dostęp sieciowy do kontrolera BMC na serwerze docelowym.

Procedury

1. Pobierz odpowiedni pakiet oprogramowania sprzętowego dla swojego urządzenia ze strony wsparcia Lenovo .
2. Rozpakuj pliki i skopiuj zawartość do określonego folderu.

Jak uzyskać informacje o zainstalowanym oprogramowaniu sprzętowym

3. Aby uzyskać dostęp do właściwości w kolekcji spisu oprogramowania sprzętowego, otwórz Postman, wybierz metodę GET ① , a następnie wprowadź następujący żądany adres URL ② : https:// BMCIP /redfish/v1/UpdateService/FirmwareInventory
4. Na karcie Autoryzacja wybierz opcję Uwierzytelnianie podstawowe z menu Typ ③ , a następnie wprowadź poświadczenia BMC ④ . Kliknij Wyślij ⑤ .
   
   Uwaga: ten etap autoryzacji jest wymagany w przypadku każdego żądania.
   Przykład odpowiedzi
   Jeśli poprzednie żądanie zakończy się pomyślnie, zostanie zwrócona treść wiadomości podobna do poniższej:

    {
       
   "@odata.context" : "/redfish/v1/$metadata#SoftwareInventoryCollection.SoftwareInventoryCollection" ,
       
   "@odata.etag" : "\"1577837046\"" ,
       
   "@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory" ,
       
   "@odata.type" : "#SoftwareInventoryCollection.SoftwareInventoryCollection" ,
       
   „Opis” : „Zbiór zasobów oprogramowania sprzętowego dostępnych dla usługi UpdateService” ,
       
   „Członkowie” : [
       
   {
       
   "@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" }
       
   ],
       
   „Członkowie@odata.count” : 8 ,
       
   "Nazwa" : "Kolekcja spisu oprogramowania sprzętowego" } 
       

5. Na liście wyników znajdź punkt końcowy oprogramowania sprzętowego systemu, do którego chcesz wysłać zapytanie — na przykład /redfish/v1/UpdateService/FirmwareInventory/UEFI . Wprowadź go w polu adresu URL, aby uzyskać informacje UEFI.

{
  
    "@odata.context" : "/redfish/v1/$metadata#UpdateService.UpdateService" ,
  
    "@odata.etag" : "\"1577837046\"" ,
  
    "@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory/UEFI" ,
  
    "@odata.type" : "#SoftwareInventory.v1_2_2.SoftwareInventory" ,
  
    „Identyfikator” : „UEFI” ,
  
    „Nazwa” : „Oprogramowanie sprzętowe UEFI” ,
  
    „Powiązany element” : [
  
{
  
            "@odata.id" : "/redfish/v1/Systems/Self"
  
},
  
{
  
            "@odata.id" : "/karmazyn/v1/Systems/1"
  
}
  
],
  
    „RelatedItem@odata.count” : 2 ,
  
    „Identyfikator oprogramowania” : „CFE118K” ,
   
    „Stan” : {
   
        „Zdrowie” : „OK” ,
   
        „Stan” : „Włączony”
   
},
   
    „Możliwość aktualizacji” : prawda ,
   
    „Wersja” : „5.10”
  
}

W danych odpowiedzi pokazanych powyżej zainstalowana wersja UEFI to 5.10 , a identyfikator oprogramowania to CFE118K .

Aktualizacje UEFI

1. Wybierz metodę POST , a następnie wprowadź następujący żądany adres URL: https:// BMCIP /redfish/v1/UpdateService/upload
2. W zakładce Treść ① dla akcji POST wybierz dane formularza ② , ustaw nazwę KLUCZ na AktualizujPlik ③ i zmień typ KLUCZA na Plik ④ .

3. W sekcji wartości wybierz obraz oprogramowania sprzętowego, który chcesz zaktualizować.

4. Otwórz edytor tekstu, taki jak Notepad++, aby utworzyć plik JSON parametrów.json o następującej treści:

 { "Cele": [ "/karmazyna/v1/Menedżerowie/Self" ] } 

5. Utwórz kolejny plik JSON oem_parameters.json z następującą zawartością:

 {
      "Typ Flash": "Aktualizacja UEFI",
      „UploadSelector”: „Domyślny”                    
} 

6. Wpisz UpdateParameters jako nazwę KEY, zmień typ KEY na File , a następnie wybierz plik parametry.json utworzony w kroku 4.
7. Wprowadź OemParameters jako kolejną nazwę KEY, zmień typ KEY na File , a następnie wybierz plik oem_parameters.json utworzony w kroku 5.
8. Kliknij Wyślij .

9. Jeśli żądanie zakończy się pomyślnie, wyświetlony zostanie kod odpowiedzi o statusie 202 Zaakceptowano . Treść wiadomości będzie podobna do poniższego przykładu:

W powyższym przykładzie odpowiedzi /redfish/v1/TaskService/Tasks/1989 jest nowym zadaniem, które właśnie zostało utworzone. Możesz użyć metody Get , aby wysłać zapytanie o stan aktualizacji za pomocą identyfikatora zadania.

Adres URL żądania

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

Przykład odpowiedzi

Działania władzy

10. Uruchom ponownie serwer i ponownie przeprowadź inwentaryzację oprogramowania sprzętowego. Wersja BIOS zostanie zaktualizowana.

Aby zresetować system, możesz także użyć metody POST .

Adres URL żądania

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

Żądana treść akcji POST:

{"ResetType":"Wymuś ponowne uruchomienie"}

Przykład odpowiedzi

Jeżeli akcja się powiodła, zwrócony zostanie status odpowiedzi 202 z następującą treścią odpowiedzi:

 {
  
    "@odata.context" : "/redfish/v1/$metadata#Task. Zadanie(stan zadania, opis, nazwa, identyfikator)" ,
  
    "@odata.id" : "/redfish/v1/TaskService/Tasks/1" ,
  
    "@odata.type" : "#Zadanie.v1_2_0.Zadanie" ,
  
    "Opis" : "Zadanie resetowania komputera" ,
  
    „Identyfikator” : „ 1 ” ,
  
    „Nazwa” : „Resetowanie komputera” ,
  
    „Stan zadania” : „Nowy”
  
} 
  

Aktualizacje BMC

1. Wybierz metodę POST, a następnie wprowadź następujący żądany adres URL:

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

2. W zakładce Treść ① dla akcji POST wybierz dane formularza ② , ustaw nazwę KLUCZ na AktualizujPlik ③ i zmień typ KLUCZA na Plik ④ .

3. W sekcji wartości wybierz obraz oprogramowania sprzętowego, który chcesz zaktualizować.

4. Otwórz edytor kodu źródłowego, taki jak Notepad++, aby utworzyć plik parametry.json JSON o następującej treści:

 { "Cele": [ "/karmazyna/v1/Menedżerowie/Self" ] } 

5. Utwórz kolejny plik JSON oem_parameters.json z następującą zawartością:

 {
      "Typ Flash": "HPMFwUpdate",
      „UploadSelector”: „Domyślny”                     
} 

6. Wpisz UpdateParameters jako nazwę KEY, zmień typ KEY na File , a następnie wybierz plik parametry.json utworzony w kroku 4.
7. Wprowadź OemParameters jako kolejną nazwę KEY, zmień typ KEY na File , a następnie wybierz plik oem_parameters.json utworzony w kroku 5.
8. Kliknij Wyślij .

9. Jeśli żądanie zakończy się pomyślnie, wyświetlony zostanie kod odpowiedzi 202 Zaakceptowano . Treść wiadomości będzie podobna do poniższego przykładu:

W powyższym przykładzie odpowiedzi /redfish/v1/TaskService/Tasks/1991 jest nowym zadaniem, które właśnie zostało utworzone. Możesz użyć metody Get , aby wysłać zapytanie o stan aktualizacji za pomocą identyfikatora zadania.

Adres URL żądania

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

Przykład odpowiedzi

10. Gdy stan zadania zostanie zakończony i dostępny będzie ThinkSystem System Manager (BMC GUI), wersja BMC zostanie zaktualizowana.

Wideo

Dodatkowe informacje

• Przewodnik po interfejsie API REST Lenovo AMD 1P SR635/655 BMC Redfish
• Strona aktualizacji oprogramowania układowego Lenovo DCG

Powiązany artykuł

• Jak zaktualizować oprogramowanie układowe SR635 i SR655 BMC za pomocą ThinkSystem System Manager
• Jak zaktualizować oprogramowanie sprzętowe UEFI SR635 i SR655 za pomocą ThinkSystem System Manager
• Jak zaktualizować oprogramowanie układowe systemu za pomocą interfejsu API REST XCC Redfish dla serwerów ThinkSystem