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
- Démarrez l'outil de scriptage wsadmin.
- 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')
- 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.
- 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.
- 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.
- 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.
- 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.