Description

Le serveur AMD 1P Redfish est basé sur le package technologique AMI MegaRAC® Redfish V1.7 (suit la spécification DSP0266 1.7.0 et le schéma Redfish 2019.1). Pour ajouter des API OEM, Redfish utilise la sémantique d'interface RESTful et les charges utiles de ressources JSON pour effectuer la gestion du système via des protocoles Web.

Cet article présente la procédure utilisée pour mettre à jour le micrologiciel du système à l'aide de l'API REST BMC Redfish.

Les méthodes HTTP suivantes seront utilisées dans cet article :

• GET : demande de lecture – utilisée pour demander une ressource ou une collection spécifiée pour vérifier les données
• POST : demande d'action – utilisée pour lancer des opérations ou créer des ressources

Systèmes applicables

SR635, SR655

Conditions préalables

• Les clients Redfish doivent être installés sur votre poste de travail ou ordinateur portable.
  • Client sébaste
    • Chrome : Postman, testeur d'API Talend
    • Firefox : RESTClient
• Le poste de travail ou l'ordinateur portable doit disposer d'un accès réseau direct au BMC sur le serveur cible.

Procédures

1. Téléchargez le package de micrologiciel approprié pour votre ordinateur à partir de la page d'assistance Lenovo .
2. Décompressez les fichiers et copiez le contenu dans un dossier spécifié.

Comment obtenir les informations sur le micrologiciel installé

3. Pour accéder aux propriétés de la collection d'inventaire du micrologiciel, ouvrez Postman, sélectionnez la méthode GET ① puis entrez l'URL demandée suivante ② : https:// BMCIP /redfish/v1/UpdateService/FirmwareInventory
4. Dans l'onglet Autorisation , sélectionnez Authentification de base dans le menu Type ③ , puis saisissez les informations d'identification BMC ④ . Cliquez sur Envoyer ⑤ .
   
   Remarque : Cette étape d'autorisation est requise pour chaque demande.
   Exemple de réponse
   Si la requête précédente aboutit, un corps de message semblable au suivant sera renvoyé :

    {
       
   "@odata.context" : "/redfish/v1/$metadata#SoftwareInventoryCollection.SoftwareInventoryCollection" ,
       
   "@odata.etag" : "\"1577837046\"" ,
       
   "@odata.id" : "/redfish/v1/UpdateService/FirmwareInventory" ,
       
   "@odata.type" : "#SoftwareInventoryCollection.SoftwareInventoryCollection" ,
       
   "Description" : "Collection des ressources d'inventaire du firmware disponibles pour UpdateService" ,
       
   "Membres" : [
       
   {
       
   "@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" }
       
   ],
       
   "Membres@odata.count" : 8 ,
       
   "Nom" : "Collection d'inventaire du micrologiciel" } 
       

5. Dans la sortie de la liste Members, recherchez le point de terminaison du micrologiciel système que vous souhaitez interroger – par exemple, /redfish/v1/UpdateService/FirmwareInventory/UEFI . Entrez-le dans le champ URL pour obtenir les informations 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" ,
  
    "Identifiant" : "UEFI" ,
  
    "Nom" : "Micrologiciel UEFI" ,
  
    "Article associé" : [
  
{
  
            "@odata.id" : "/redfish/v1/Systems/Self"
  
},
  
{
  
            "@odata.id" : "/redfish/v1/Systems/1"
  
}
  
],
  
    "RelatedItem@odata.count" : 2 ,
  
    "Logiciel" : "CFE118K" ,
   
    "Statut" : {
   
        "Santé" : "OK" ,
   
        "État" : "Activé"
   
},
   
    "Mise à jour" : vrai ,
   
    "Version" : "5.10"
  
}

Dans les données de réponse indiquées ci-dessus, la version UEFI installée est 5.10 et l'ID du logiciel est CFE118K .

Mises à jour UEFI

1. Sélectionnez la méthode POST , puis entrez l'URL demandée suivante : https:// BMCIP /redfish/v1/UpdateService/upload
2. Dans l'onglet Corps ① de l'action POST, sélectionnez form-data ② , définissez le nom KEY sur UpdateFile ③ et modifiez le type KEY sur File ④ .

3. Dans la section valeur, sélectionnez l'image du micrologiciel que vous souhaitez mettre à jour.

4. Ouvrez un éditeur de texte tel que Notepad++ pour créer un fichier JSON settings.json avec le contenu suivant :

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

5. Créez un autre fichier JSON oem_parameters.json avec le contenu suivant :

 {
      "FlashType": "UEFIMise à jour",
      "UploadSelector": "Par défaut"                    
} 

6. Entrez UpdateParameters comme nom KEY, modifiez le type KEY en File , puis sélectionnez le fichier settings.json que vous avez créé à l'étape 4.
7. Entrez OemParameters comme autre nom KEY, modifiez le type KEY en File , puis sélectionnez le fichier oem_parameters.json que vous avez créé à l'étape 5.
8. Cliquez sur Envoyer .

9. Si la demande réussit, l'état du code de réponse 202 Accepté sera affiché. Le corps du message sera similaire à l'exemple suivant :

Dans l'exemple de réponse ci-dessus, /redfish/v1/TaskService/Tasks/1989 est la nouvelle tâche qui vient d'être créée. Vous pouvez utiliser la méthode Get pour interroger l'état de la mise à jour avec l'ID de la tâche.

URL de la demande

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

Exemple de réponse

Actions de pouvoir

10. Redémarrez le serveur et effectuez à nouveau l'inventaire du micrologiciel. La version BIOS aura été mise à jour.

Vous pouvez également utiliser la méthode POST pour effectuer une réinitialisation du système.

URL de la demande

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

Corps demandé de l’action POST :

{"ResetType": "Forcer le redémarrage"}

Exemple de réponse

Si l'action a réussi, l'état de réponse 202 sera renvoyé avec le corps de réponse suivant :

 {
  
    "@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" ,
  
    "Description" : "Tâche de réinitialisation de l'ordinateur" ,
  
    "Id" : " 1 " ,
  
    "Nom" : "Réinitialisation de l'ordinateur" ,
  
    "État de la tâche" : "Nouveau"
  
} 
  

Mises à jour du BMC

1. Sélectionnez la méthode POST, puis entrez l'URL demandée suivante :

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

2. Dans l'onglet Corps ① de l'action POST, sélectionnez form-data ② , définissez le nom KEY sur UpdateFile ③ et modifiez le type KEY sur File ④ .

3. Dans la section valeur, sélectionnez l'image du micrologiciel que vous souhaitez mettre à jour.

4. Ouvrez un éditeur de code source tel que Notepad++ pour créer un fichier JSON settings.json avec le contenu suivant :

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

5. Créez un autre fichier JSON oem_parameters.json avec le contenu suivant :

 {
      "FlashType": "HPMFwUpdate",
      "UploadSelector": "Par défaut"                     
} 

6. Entrez UpdateParameters comme nom KEY, modifiez le type KEY en File , puis sélectionnez le fichier settings.json que vous avez créé à l'étape 4.
7. Entrez OemParameters comme autre nom KEY, modifiez le type KEY en File , puis sélectionnez le fichier oem_parameters.json que vous avez créé à l'étape 5.
8. Cliquez sur Envoyer .

9. Si la demande réussit, l'état du code de réponse 202 Accepté sera affiché. Le corps du message sera similaire à l'exemple suivant :

Dans l'exemple de réponse ci-dessus, /redfish/v1/TaskService/Tasks/1991 est la nouvelle tâche qui vient d'être créée. Vous pouvez utiliser la méthode Get pour interroger l'état de la mise à jour avec l'ID de la tâche.

URL de la demande

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

Exemple de réponse

10. Lorsque l'état de la tâche est terminé et que ThinkSystem System Manager (interface graphique BMC) est accessible, la version BMC sera mise à jour.

Vidéo

Informations Complémentaires

• Guide de l'API REST Lenovo AMD 1P SR635/655 BMC Redfish
• Page de mise à jour du micrologiciel Lenovo DCG

Article associé

• Comment mettre à jour le micrologiciel SR635 et SR655 BMC à l'aide de ThinkSystem System Manager
• Comment mettre à jour le micrologiciel UEFI SR635 et SR655 à l'aide de ThinkSystem System Manager
• Comment mettre à jour le micrologiciel du système à l'aide de l'API REST XCC Redfish pour les serveurs ThinkSystem