Mise à jour des versions des microprogrammes des appliances DataPower à l'aide de scripts

Utilisez l'outil wsadmin pour mettre à jour le microprogramme des appliances au sein d'un ensemble géré. Les fichiers de version de microprogramme de l'éditeur sont spécifiques des types d'unités, de modèles et des bibliothèques de fonctions.

Avant de commencer

Avant de commencer, configurez le gestionnaire d'appliances DataPower en ajoutant et configurant les appliances et les ensembles gérés.

Pourquoi et quand exécuter cette tâche

Cette rubrique fournit un exemple de mise à jour du microprogramme de plusieurs appliances administrées par un gestionnaire d'appliancesDataPower, dans le cadre d'un ensemble géré. Les appliances visées sont membres de l'ensemble gérétestSet. Lors de la mise à jour du microprogramme dans un ensemble géré qui gère plusieurs appliances, le système déploie la version de microprogramme sur l'appliance maîtresse, puis, progressivement sur chaque appliance de l'ensemble géré.

Pour consulter des informations et des exemples complémentaires des commandes dans cette rubrique, consultez la documentation du groupe de commandes dpManagerCommands pour l'objet AdminTask.

Procédure

  1. Démarrez l'outil de scriptage wsadmin.
  2. Déterminez les ID des ensembles gérés.
    Utilisez la commande dpGetAllManagedSetIDs pour afficher les ID de chaque ensemble géré dans la configuration du gestionnaire d'appliances DataPower, tel que démontré par la commande suivante :
    AdminTask.dpGetAllManagedSetIds()
    Vous pouvez, en option, utiliser la commande dpGetManagedSet pour afficher les attributs d'un ID d'ensemble géré spécifique donné, tel qu'illustré dans l'exemple suivant :
    AdminTask.dpGetManagedSet('-managedSetId testSet')
  3. Déterminez la version de microprogramme à déployer sur chaque ensemble géré.

    Vous pouvez utiliser le gestionnaire d'appliances DataPower pour déployer une nouvelle version de microprogramme dans votre configuration ou pour revenir à une version de microprogramme antérieure, présente dans votre configuration.

    • Pour déployer de nouvelles versions de microprogrammes dans votre configuration, téléchargez les versions de microprogrammes souhaitées à partir du site Web DataPower. Il n'est pas nécessaire de télécharger de nouvelles versions de microprogrammes si vous ne faites que revenir à une version antérieure, présente dans votre configuration. Après avoir téléchargé les nouvelles versions de microprogrammes, utilisez la commande dpAddFirmwareVersion pour ajouter la version de microprogramme locale au gestionnaire d'appliancesDataPower. La version du microprogramme est associée à un microprogramme spécifique, qui sert de conteneur pour chaque version de microprogramme qui possède le même type d'appliance, de modèle et des fonctions compatibles. L'exemple de commande suivant permet d'ajouter une version de microprogramme au gestionnaire d'appliances DataPower :
      addFirmwareTask=AdminTask.dpAddFirmwareVersion('[-file "C:\temp\dptestFW\dev-xs-143863-3_6_0_16.scrypt2"
       -userComment "my new firmware for test"]')
      La commande soumet les tâches au gestionnaire d'appliances DataPower et attribue aux ID de tâches les valeurs des variables correspondantes. Utilisez les commandes de l'exemple suivant pour surveiller l'état des tâches :
      param = '-taskId '+addFirmwareTask 
      print AdminTask.dpGetTask(param) 
      La commande renvoie les informations concernant la tâche et l'ID de la version de microprogramme en tant que valeur de l'attribut result, tel qu'illustré dans l'exemple de résultat suivant :
      [ [currentStep 0] [totalSteps 0] [taskDescription
       [Add new firmware version to the DataPower appliance manager]] 
       [currentStepTimestamp [Jan 18, 2008 2:32:25 PM]] [creationDate [Jan 18, 2008 2:32:23 PM]] 
       [taskStatus 2] [taskId 1] [hasError false] [createdByUser defaultWIMFileBasedRealm/admin]
       [isComplete true] [result [XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15]] ] 
      Vous pouvez utiliser la commande dpGetAllFirmwareIds pour afficher l'ID de chaque microprogramme disponible. Utilisez ensuite la commande dpGetAllFirmwareVersionIDs pour obtenir les ID de chaque version de microprogramme disponible du microprogramme visé. Une fois les ID de la version de microprogramme à utiliser trouvés, attribuez à l'attribut result la valeur d'une variable à utiliser dans la commande utilisée pour déployer la version de microprogramme dans l'ensemble géré, tel qu'illustré dans l'exemple suivant :
      testFirmwareVersionID = 'XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15'
    • Pour déployer une version de microprogramme existante dans l'ensemble géré, utilisez les commandes suivantes pour déterminer les versions de microprogramme visé :
      • Utilisez la commande dpGetAllFirmwareVersionIds pour afficher les ID de version de chaque version de microprogramme d'un microprogramme spécifique, tel qu'illustré dans l'exemple suivant :
        AdminTask.dpGetAllFirmwareVersionIds('-firmwareId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;"')
      • Dans cet exemple, il existe les deux versions de microprogrammes suivantes :
        XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15
        XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.16
      • Vous pouvez, en option, utiliser la commande dpGetFirmware pour afficher le type d'appliance, le type de modèle, les fonctions strictes et non strictes du microprogramme, tel qu'illustré dans l'exemple suivant :
        AdminTask.dpGetFirmware('-firmwareId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;"')
      • Si vous n'êtes pas sûr du microprogramme à utiliser, la commande dpGetBestFirmware permet de rechercher le microprogramme adapté à votre type d'appliance, de modèle et aux fonctions de votre appliance. La commande ne recommande, en revanche, pas un microprogramme spécifique. Elle détermine le microprogramme qui correspond à votre configuration. Dans l'exemple suivant, la commande recherche un microprogramme qui contient la version de microprogramme 3.6.0.4 :
        AdminTask.dpGetBestFirmware('-applianceType "XS40" -modelType "9002" -applianceFeatures "JAXP-API" -level "3.6.0.4"')
  4. Vérifiez que le système a ajouté la nouvelle version de microprogramme au gestionnaire d'appliances DataPower.
    Utilisez la commande getTask pour déterminer si la tâche est terminée, tel qu'illustré dans l'exemple suivant :
    AdminTask.dpGetTask('-taskId '+addFirmwareTask)

    La commande renvoie des informations concernant la tâche asynchrone visée. L'attribut isComplete affiche la valeur true si la tâche est terminée. Si elle n'est pas terminée, notez la valeur de l'attribut taskStatus. Si le résultat est 0, cela signifie que la tâche est dans une file d'attente et que le système n'a pas démarré la tâche. Si le résultat est 1, cela signifie que la tâche est en cours d'exécution. Si le résultat est 2, cela signifie que la tâche s'est terminée avec succès. Si le résultat est 3, cela signifie que la tâche a rencontré une exception.

  5. Déployez la version du microprogramme
    Une fois que le système a ajouté la version de microprogramme au gestionnaire d'appliances DataPower, utilisez la commande dpSetManagedSet pour attribuer la version de microprogramme à l'ensemble géré. L'exemple suivant attribue la version de microprogramme fraîchement téléchargée à l'ensemble géré de l'environnement de test :
    FVTask=AdminTask.dpSetManagedSet('-managedSetId testSet -desiredFirmwareVersionId '+testFirmwareVersionID)

    La commande soumet les tâches au gestionnaire d'appliances DataPower et attribue les identificateurs de tâches aux variables correspondantes. Le déploiement d'un microprogramme peut prendre plusieurs minutes et nécessite le redémarrage de l'appliance pour lancer la nouvelle version de microprogramme.

  6. Vérifiez que le système a bien attribué les nouvelles versions de microprogrammes aux ensembles gérés.
    Utilisez la commande getTask pour déterminer si la tâche est terminée, tel qu'illustré dans l'exemple suivant :
    AdminTask.dpGetTask('-taskId '+FVTask)

    La commande renvoie des informations concernant la tâche asynchrone visée. L'attribut isComplete affiche la valeur true si la tâche est terminée. Si elle n'est pas terminée, notez la valeur de l'attribut taskStatus. Si le résultat est 0, cela signifie que la tâche est dans une file d'attente et que le système n'a pas démarré la tâche. Si le résultat est 1, cela signifie que la tâche est en cours d'exécution. Si le résultat est 2, cela signifie que la tâche s'est terminée avec succès. Si le résultat est 3, cela signifie que la tâche a rencontré une exception.

  7. Facultatif : Supprimez la version de microprogramme remplacée par le système, dans le gestionnaire d'appliances DataPower.

    Si vous ne souhaitez pas conserver une copie de la version de microprogramme antérieure sur le gestionnaire d'appliances DataPower, supprimez la version de microprogramme de votre configuration. Vous souhaiterez peut-être conserver les deux versions de microprogramme antérieures au cas où vous deviez revenir à la version antérieure.

    Utilisez la commande dpRemoveFirmwareVersion pour supprimer la version de microprogramme qui n'est plus utilisée par l'ensemble géré. Vous ne pouvez pas supprimer les versions de microprogrammes attribuées à des ensembles gérés. L'exemple suivant supprime la version de microprogramme du gestionnaire d'appliances DataPower :
    AdminTask.dpRemoveFirmwareVersion('-firmwareVersionId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.13"')

Résultats

L'ensemble géré utilise la nouvelle version de microprogramme.

Que faire ensuite

Vous pouvez utiliser l'outil wsadmin pour gérer des appliances, des microprogrammes, des domaines, des ensembles gérés et des paramètres spécifiques des appliances. Le système crée, en outre, des versions de domaines, des microprogrammes et des paramètres spécifiques des appliances. Vous pouvez utiliser l'outil wsadmin pour modifier la version actuelle ou revenir à des versions antérieures de domaines, microprogrammes et paramètres spécifiques des appliances.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_7dpfirmware
Nom du fichier : txml_7dpfirmware.html