Utilisez le serveur d'applications et l'outil wsadmin pour configurer, interroger et administrer vos appliances DataPower dans le gestionnaire d'appliances DataPower. Les appliances DataPower sont des périphériques réseau spécialement élaborés et faciles à déployer, dont la finalité est de simplifier, sécuriser et accélérer les déploiements de services XML et Web.
Avant de commencer
Avant de commencer, vérifiez que chaque appliance que vous voulez ajouter a un microprogramme 3.6.0.4 ou supérieur. Vérifiez également que le noeud final AMP (Appliance Management Protocol) est activé pour chaque appliance.
Si le noeud final AMP d'interface de gestion XML était désactivé pendant
l'installation, utilisez l'interface Web DataPower pour l'activer.
Le certificat racine DataPower, situé à l'emplacement racine_serveur_app/profiles/nom_profil/etc/DataPower-root-ca-cert.pem, est fourni en tant que composant du fichier de clés par défaut. Lors de la création de profil, ce certificat peut uniquement être ajouté
aux magasins de clés basés sur fichier. Les fichiers de clés SAF n'étant pas basés sur des fichiers, le certificat doit être ajouté manuellement au fichier de clés RACF.
Pourquoi et quand exécuter cette tâche
Cette rubrique explique comment ajouter des appliances DataPower au gestionnaire d'appliances DataPower, créer des ensembles gérés et attribuer des appliances à des ensembles gérés dans votre environnement. Vous pouvez ajouter autant d'appliances et d'ensembles gérés que vous le souhaitez.
Les exemples de cette rubrique montrent comment configurer le gestionnaire d'appliances DataPower pour administrer deux ensembles gérés d'appliances DataPower, mettre à jour le microprogramme des appliances et configurer les domaines. Le premier ensemble géré représente un environnement de production mettant en oeuvre trois appliances DataPower. Le deuxième ensemble géré représente un environnement de test qui utilise une appliance DataPower. Avec cette configuration, vous pouvez utiliser le deuxième ensemble géré dans l'environnement de test pour modifier et tester les paramètres de l'appliance DataPower, avant d'importer le domaine de l'appliance de test dans votre environnement de production. Modifiez les exemples pour adapter la configuration au mieux à votre environnement.
Pour consulter des informations et des exemples complémentaires concernant les commandes de cette rubrique, consultez la documentation du groupe de commandes
dpManagerCommands pour l'objet AdminTask.
Procédure
- Démarrez l'outil de scriptage wsadmin.
- Ajoutez les appliances DataPower à la configuration du gestionnaire d'appliances DataPower.
Utilisez la commande
dpAddAppliance pour ajouter des appliances au gestionnaire d'appliances
DataPower. Chaque appel de commande crée une tâche dans le gestionnaire d'appliances DataPower et renvoie l'identificateur de tâche en tant que résultat de la commande. Les commandes suivantes permettent d'ajouter les appliances
ProductionAppliance1,
ProductionAppliance2,
ProductionAppliance3 et
TestAppliance1 à votre configuration et d'attribuer l'identificateur de tâche à une variable spécifique :
app1Task=AdminTask.dpAddAppliance('[-hostname ProductionAppliance1.ibm.com -hlmPort 5550 –name ProductionAppliance1 -userId admin -password mypassword]')
app2Task=AdminTask.dpAddAppliance('[-hostname ProductionAppliance2.ibm.com -hlmPort 5550 –name ProductionAppliance2 -userId admin -password mypassword]')
app3Task=AdminTask.dpAddAppliance('[-hostname ProductionAppliance3.ibm.com -hlmPort 5550 –name ProductionAppliance3 -userId admin -password mypassword]')
testAppTask=AdminTask.dpAddAppliance('[-hostname TestAppliance1.ibm.com -hlmPort 5550 –name TestAppliance1 -userId admin -password mypassword]')
Le gestionnaire d'appliances DataPower soumet les tâches, pour ajouter les appliances à la configuration. Si la tâche en question utilise une ressource utilisée par une autre tâche, le système met la nouvelle tâche en file d'attente jusqu'à ce que l'autre tâche soit terminée.
Utilisez les commandes de l'exemple suivant pour surveiller l'état des tâches :
param = '-taskId '+app1Task; print AdminTask.dpGetTask(param)
La commande renvoie les informations de la tâche et l'ID de l'appliance dans l'attribut
result (résultat), tel qu'illustré dans l'exemple de résultat suivant :
[ [currentStep 0] [totalSteps 0] [taskDescription [Add appliance ProductionAppliance1 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 [00605 20356]] ]
Une fois que le système a ajouté chaque appliance à votre configuration, les appliances sont des appliances non gérées.
Pour gérer chaque appliance, attribuez chaque appliance à un ensemble géré.
- Ajoutez la version du microprogramme au gestionnaire d'appliances DataPower.
Utilisez la commande dpAddFirmwareVersion pour ajouter la version du microprogramme utilisée par l'appliance
ProductionAppliance2 au gestionnaire d'appliances DataPower. L'appliance
ProductionAppliance2 sera définie en tant qu'appliance maîtresse, un peu plus loin dans cette rubrique. Ainsi, chaque appliance se trouvant dans le même ensemble géré que l'appliance
ProductionAppliance2 utilisera la même version du microprogramme.
firmwareTask=AdminTask.dpAddFirmwareVersion('[-file
"C:\temp\dptestFW\dev-xs-143863-3_6_0_15.scrypt2" -userComment "my new firmware"]')
Eviter les incidents: N'utilisez pas de microprogramme
DataPower de niveau 3.6.0.28, 3.6.0.29 ou 3.6.0.30 pour un ensemble
géré.
gotcha
Habituellement, quand vous créez un ensemble d'appliances
DataPower, le gestionnaire d'appliances DataPower exécute les
processus suivants :
- Il crée une version des paramètres d'appliance partageables à
partir des paramètres d'appliance partageables sur l'appliance
principale.
- Il synchronise les paramètres dans tout l'ensemble géré. Ce processus de synchronisation est répété chaque fois que les
paramètres d'appliance partageables changent sur l'appliance
principale.
De même, quand vous ajoutez un domaine à un ensemble géré dans le
gestionnaire d'appliances DataPower, ce dernier exécute les processus
suivants :
- Il crée une version du domaine à partir du domaine lié à
l'appliance principale.
- Il synchronise la version du domaine dans tout l'ensemble géré. Ce processus de synchronisation est répété chaque fois que le domaine
change sur l'appliance principale.
Si vous utilisez le niveau de microprogramme DataPower 3.6.0.28,
3.6.0.29 ou 3.6.0.30 pour un ensemble géré, le gestionnaire
d'appliance DataPower risque de créer inutilement des nouvelles
versions des paramètres d'appliance partageables, ou des versions de
domaine, puis de synchroniser ces nouvelles versions dans tout
l'ensemble géré.
Cette commande soumet une tâche au système pour ajouter le microprogramme et attribue l'identificateur de tâche à la variablefirmwareTask.
- Ajoutez les ensembles gérés dans votre configuration de gestionnaire d'appliances DataPower.
Utilisez la commande dpAddManagedSet pour ajouter des ensembles gérés au gestionnaire d'appliances DataPower. Chaque appel de commande crée une tâche dans le gestionnaire d'appliances DataPower et renvoie l'identificateur de tâche en tant que résultat de la commande. Les commandes suivantes permettent de créer les ensembles gérés
testSet et
productionSet dans votre configuration :
AdminTask.dpAddManagedSet('-name testSet')
AdminTask.dpAddManagedSet('-name productionSet')
La commande soumet la tâche au gestionnaire d'appliances DataPower.
- Vérifiez que le système a bien ajouté chaque appliance et ensemble géré à votre configuration.
Les commandes dpAddAppliance etdpAddManagedSet peuvent ne pas s'exécuter dans leur totalité immédiatement. Avant d'ajouter les appliances aux ensembles gérés, vérifiez que le système a terminé les tâches des commandes antérieures. Si vous n'avez pas associé le résultat des commandes à des variables au cours des étapes précédentes, utilisez la commande suivante pour afficher chaque identificateur de tâche à partir du gestionnaire d'appliances DataPower :
AdminTask.dpGetAllTaskIds()
Sinon, utilisez la commande
dpGetTask pour déterminer si le système a terminé les tâches. Exécutez la commande pour chaque tâche, tel qu'illustré dans les commandes suivantes :
AdminTask.dpGetTask('-taskId '+app1Task)
AdminTask.dpGetTask('-taskId '+app2Task)
AdminTask.dpGetTask('-taskId '+app3Task)
AdminTask.dpGetTask('-taskId '+testAppTask)
AdminTask.dpGetTask('-taskId '+prodSetTask)
AdminTask.dpGetTask('-taskId '+firmwareTask)
AdminTask.dpGetTask('-taskId '+prodSetTask)
Les commandes renvoient des informations au sujet de 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.
Pour une description des attributs supplémentaires susceptibles d'être renvoyés par la commande, consultez la documentation du groupe de commandes dpManagerCommands pour l'objet AdminTask.
- Attribuez les appliances de production à l'ensemble géré de production.
Pour attribuer les appliances à l'ensemble géré, vous devez connaître les ID des appliances visées. Utilisez la commande dpGetAllApplianceIds pour afficher les ID de chaque appliance dans votre configuration, tel qu'illustré dans l'exemple suivant :
AdminTask.dpGetAllApplianceIds()
La commande dpGetAppliance permet d'afficher des informations supplémentaires sur un ID d'appliance spécifique, tel qu'illustré dans l'exemple suivant :
AdminTask.dpGetAppliance('[-applianceId "00605 20356"]')
Utilisez la commande dpManageAppliance pour ajouter chaque appliance à l'ensemble géré, en indiquant l'ID de chaque appliance à ajouter à cet ensemble géré.
Eviter les incidents: Pour attribuer plusieurs appliances à un ensemble géré, chaque appliance doit être du même type, tel que XI50 ou XS40, et de même modèle. De plus, les mêmes fonctionnalités doivent être installées sur toutes les appliances. En vérifiant que chaque appliance est parfaitement identique, vous vous assurez que le gestionnaire d'appliances DataPower peut synchroniser les mêmes microprogrammes, domaines et paramètres de chaque appliance dans l'ensemble géré.
gotcha
Les exemples de commandes suivants ajoutent les appliances
ProductionAppliance1,
ProductionAppliance2
et
ProductionAppliance3 à l'ensemble géré
productionSet et
définissent l'appliance
ProductionAppliance2 en tant qu'appliance maîtresse. Si vous ne définissez pas d'appliance maîtresse, le système fait automatiquement de la première appliance, l'appliance maîtresse.
manageTask1=AdminTask.dpManageAppliance('[-managedSetId productionSet -applianceId "00605 20351"]')
manageTask2=AdminTask.dpManageAppliance('[-managedSetId productionSet -applianceId "00605 20352" -asMaster]')
manageTask3=AdminTask.dpManageAppliance('[-managedSetId productionSet -applianceId "00605 20353"]')
La commande soumet une tâche au système et attribue aux identificateurs de tâches correspondants les valeurs des variables manageTask1, manageTask2
et manageTask3.
- Attribuez l'appliance test à l'ensemble géré de test.
La commande suivante utilise la commande dpManageAppliance pour ajouter l'appliance
TestAppliance1 à l'ensemble géré
testSet, en indiquant comme ID d'appliance, l'appliance
TestAppliance1 :
manageTask4=AdminTask.dpManageAppliance('[-managedSetId testSet -applianceId "00605 20354"]')
La commande soumet une tâche au système et attribue à l'identificateur de tâche correspondant la valeur de la variable manageTask4.
- Vérifiez que le système a bien ajouté les appliances aux ensembles gérés.
Utilisez la commande dpGetTask pour déterminer l'état des tâches manageTask1, manageTask2, manageTask3
et manageTask4 avant de poursuivre la configuration du gestionnaire d'appliances DataPower.
Résultats
Un ensemble géré d'environnement de test et un ensemble géré d'environnement de production sont disponibles dans la configuration du gestionnaire d'appliances DataPower de cet exemple. L'ensemble géré de l'environnement de test gère l'appliance TestAppliance1.
L'ensemble géré de l'environnement de production gère les appliances ProductionAppliance1, ProductionAppliance2
et ProductionAppliance3. Chaque appliance de ces deux ensembles gérés utilise le domaine par défaut.
Que faire ensuite
Vous pouvez utiliser l'interface utilisateur graphique Web DataPower pour configurer des domaines pour l'appliance testAppliance1 dans l'environnement de test, en cas d'absence de domaines. Après avoir configuré, puis testé les domaines, vous pouvez utiliser l'outil wsadmin pour copier la configuration de l'appliance de l'environnement de test dans l'ensemble géré de l'environnement de production.
Vous pouvez aussi utiliser cet 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érieurs de domaines, microprogrammes et paramètres spécifiques des appliances.