Utilisez l'outil wsadmin pour administrer le domaine géré et l'historique des versions de microprogrammes pour le gestionnaire d'appliances DataPower.
Vous pouvez revenir aux versions de domaine et de microprogrammes précédentes, présentes dans le gestionnaire d'appliances DataPower.
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
Quand un administrateur DataPower modifie le domaine, le microprogramme ou les paramètres, le gestionnaire d'appliances DataPower crée automatiquement une copie de la configuration précédente (domaine, microprogramme et versions de paramètres), si les conditions suivantes s'appliquent :
- Le gestionnaire d'appliances DataPower crée des versions de domaines si l'appliance se trouve dans un ensemble géré et le domaine est géré.
- Le gestionnaire d'appliances DataPower ne crée que des versions de microprogrammes quand l'administrateur ajoute de nouvelles versions de microprogrammes au gestionnaire d'appliances DataPower.
- Le gestionnaire d'appliances DataPower crée des versions de paramètres si l'appliance est configurée dans un ensemble géré.
Vous pouvez utiliser l'outil wsadmin pour consulter un historique des versions, revenir à une version de domaine précédente ou copier une version de domaine dans un autre ensemble géré. Cette rubrique propose des exemples de modification de domaine, de microprogramme et des versions de paramètres. Pour consulter des informations et des exemples complémentaires des commandes de cette rubrique, consultez la documentation du groupe de commandes dpManagerCommands pour l'objet AdminTask.
Procédure
- Administrez les versions des domaines gérés.
- Démarrez l'outil de scriptage wsadmin.
- Affichez les ID des ensembles gérés dans votre configuration.
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()
- Affichez chaque domaine géré par un ensemble géré spécifique.
Utilisez la commande dpGetAllMSDomainIds pour afficher les ID de domaine de chaque domaine d'un ensemble géré spécifique, tel qu'illustré dans l'exemple suivant :
AdminTask.dpGetAllMSDomainIds('[-managedSetId myManagedSet]')
- Affichez chaque version de domaine existante pour un domaine spécifique.
Utilisez la commande dpGetAllMSDomainVersionIds pour afficher les ID de version de domaine pour chaque version de domaine existante pour un domaine spécifique, tel qu'illustré dans l'exemple suivant :
AdminTask.dpGetAllMSDomainVersionIds('[-msDomainId myManagedSet:domain1]')
Pour cet exemple, la commande renvoie la sortie suivante :
[myManagedSet:domain1:1, myManagedSet:domain1:2, myManagedSet:domain1:3, myManagedSet:domain1:4]
- Affichez les informations sur la version de domaine.
Utilisez la commande dpGetMSDomainVersion
pour afficher les informations de version de domaine détaillées, y compris la date et l'heure auxquelles le gestionnaire d'appliances DataPower a créé la version et les commentaires, tel qu'illustré dans l'exemple suivant :
AdminTask.dpGetMSDomainVersion('[-msDomainVersionId myManagedSet:domain1:1]')
- Indiquez un commentaire au sujet de la version de domaine.
Utilisez la commande dpSetDomainVersion pour indiquer un commentaire pour un domaine, tel qu'illustré dans l'exemple suivant :
AdminTask.dpSetFirmwareVersion('-firmwareVersionId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15"
-userComment "revert to firmware version 3.6.0.15"')
- Modifiez la première version du domaine.
Utilisez la commande
dpSetMSDomainVersion pour modifier la version du domaine utilisé par l'ensemble géré, tel qu'illustré dans l'exemple suivant :
AdminTask.dpSetMSDomainVersion('[-msDomainVersionId myManagedSet:domain1:2 -userComment
"revert to previous version"]')
- Administrez les versions de microprogrammes.
- Démarrez l'outil de scriptage wsadmin.
- Affichez les ID de microprogramme dans votre configuration.
Utilisez la commande dpGetAllFirmwareIds pour afficher les ID de chaque microprogramme dans la configuration du gestionnaire d'appliancesDataPower, tel que démontré dans la commande suivante :
AdminTask.dpGetAllFirmwareIds()
- Affichez les versions de microprogrammes existantes pour un microprogramme spécifique.
Utilisez la commande dpGetAllFirmwareVersionIds pour afficher chaque ID de version de microprogramme du microprogramme visé, tel qu'illustré dans l'exemple suivant :
AdminTask.dpGetAllFirmwareVersionIds('-firmwareId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;"')
Pour cet exemple, la commande renvoie la sortie suivante :
[XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15, XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.16]
- Indiquez un commentaire pour une version de microprogramme.
Utilisez la commande
dpSetFirmwareVersion pour indiquer un commentaire pour une version de microprogramme, tel qu'illustré dans l'exemple suivant :
AdminTask.dpSetFirmwareVersion('-firmwareVersionId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15"
-userComment "revert to firmware version 3.6.0.15"')
- Définissez la version de microprogramme pour l'ensemble géré.
Utilisez la
commande dpSetManagedSet pour attribuer la version de microprogramme à l'ensemble géré, tel qu'illustré dans l'exemple suivant :
AdminTask.dpSetManagedSet('-managedSetId testSet -desiredFirmwareVersionId
XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15')
- Administrez les versions de paramètres.
- Affichez les ID des ensembles gérés dans votre configuration.
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()
- Affichez des informations complémentaires au sujet de l'ensemble géré visé.
Utilisez la commande dpGetManagedSet pour afficher les attributs de configuration de l'ensemble géré. La valeur de l'attribut
settingsId représente l'objet paramètres de l'ensemble géré visé.
AdminTask.dpGetManagedSet('-managedSetId myManagedSet')
- Affichez chaque version des paramètres visés.
Utilisez la commande
dpGetAllMSSettingsVersionIds pour afficher l'ID de chaque version de paramètres pour les paramètres visés, tel qu'illustré dans l'exemple suivant :
AdminTask.dpGetAllMSSettingsVersionIds('-msSettingsId mySettings')
Pour cet exemple, la commande renvoie la sortie suivante :
[myManagedSet:1, myManagedSet:2, MyManagedSet:3]
- Déterminez la version de paramètres utilisée actuellement par l'ensemble géré.
Utilisez la commande dpGetMSSettings pour afficher les attributs de configuration de la version de paramètres utilisée actuellement par l'ensemble géré. Dans le résultat de la commande, l'attribut
desiredSettingsVersionId représente la version de paramètres utilisée par l'ensemble géré.
AdminTask.dpGetMSSettings('-msSettingsId mySettings')
Pour cet exemple, la commande renvoie la sortie suivante :
[MyManagedSet:3]
- Définissez la version de paramètres utilisée par l'ensemble géré.
Utilisez la commande dpSetMSSettings pour définir la version de paramètres à utiliser pour l'ensemble géré, tel qu'illustré dans l'exemple suivant :
AdminTask.dpSetMSSettings('-msSettingsId myMS1 -desiredSettingsVersionId myMS1:1')
- Indiquez un commentaire pour une version de paramètres.
Utilisez
la commande dpSetMSSettingsVersion pour indiquer un commentaire pour une version de paramètres dans votre configuration, tel qu'illustré dans l'exemple suivant :
AdminTask.dpSetMSSettingsVersion('[-msSettingsVersionId myManagedSet:2 -userComment
"added new timeserver"]')
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.