Gestion des unités de composition à l'aide de l'outil de scriptage wsadmin
Les commandes du groupes de commandes BLAManagement permettent de gérer les unités de composition. Utilisez les exemples de cette rubrique pour ajouter, supprimer, éditer, exporter et consulter des unités de composition.
Avant de commencer
Vous disposez de deux méthodes pour effectuer cette tâche. Utilisez le groupe de commandes BLAManagement pour l'objet AdminTask pour gérer les unités de composition. Vous pouvez aussi utiliser les scripts de la bibliothèque de scripts AdminBLA pour administrer vos configurations d'unités de composition.
Pourquoi et quand exécuter cette tâche
Les unités de composition peuvent représenter des actifs déployés, d'autres applications de niveau métier ou des artefacts externes déployés dans des exécutions autres que WebSphere Application Server, sans actifs associés. Le nombre d'unités de composition contenu dans une application de niveau métier peut varier de zéro à plusieurs. Vous ne pouvez pas ajouter la même unité de composition à plus d'une application de niveau métier, mais vous pouvez utiliser un actif pour créer plusieurs unités de composition.
Procédure
- Ajoutez des unités de composition.
- Démarrez l'outil de scriptage wsadmin.
- Ajoutez des unités de composition. Utilisez la commande addCompUnit pour ajouter des unités de composition à des applications de niveau métier.Remarque : Si l'actif est un actif EBA, des paramètres supplémentaires doivent être définis. Pour plus d'informations, voir Ajout d'un actif EBA à une unité de composition à l'aide de la commande addCompUnit.Utilisez l'exemple de commande suivant pour ajouter l'actif asset1 en tant qu'unité de composition dans l'application de niveau métier myBLA et mapper le déploiement vers le serveur server1 :
AdminTask.addCompUnit('-blaID myBLA cuSourceID asset1 -CUOptions [[.* .* compositionUnit1 "unité de composition ayant comme renfort l'actif asset1" 0]] -MapTargets [[.* server1]] ActivationPlanOptions [.* specname=actplan0+specname=actplan1]')
Utilisez la commande suivante pour ajouter l'actif asset2 en tant qu'unité de composition dans l'application de niveau métier myBLA et mapper le déploiement vers les serveurs server1 et testServer :AdminTask.addCompUnit('-blaID myBLA cuSourceID asset2 -CUOptions [[.* .* compositionUnit2 "unité de composition ayant comme renfort l'actif asset2" 0]] -MapTargets [[.* server1+testServer]] ActivationPlanOptions [.* specname=actplan0+specname=actplan1]')
Utilisez la commande suivante pour ajouter l'actif J2EEAsset en tant qu'unité de composition dans l'application de niveau métier myBLA et mapper le déploiement vers les serveurs server1 et testServer :AdminTask.addCompUnit('[-blaID myBLA cuSourceID J2EEAsset defaultBindingOptions defaultbinding.ejbjndi.prefix=ejb# defaultbinding.virtual.host=default_host# defaultbinding.force=yes AppDeploymentOptions [-appname defaultapp -installed.ear.destination application_root/myCell/defaultapp.ear] MapModulesToServers [[defaultapp.war .* WebSphere:cell=cellName,node=nodeName,server=server1][Increment.jar .* Websphere:cell=cellName,node=nodeName,server=testServer]] -CtxRootForWebMod [[defaultapp.war .* myctx/]]]')
Si vous éditez une unité de composition pour mettre à jour une bibliothèque partagée, vous devez tout d'abord arrêter manuellement toutes les applications Java EE qui dépendent de cette bibliothèque partagée. Après avoir mis à jour la bibliothèque partagée, redémarrez manuellement les applications Java EE. Les applications Java EE ne redémarrent pas automatiquement lorsqu'une bibliothèque partagée est mise à jour.
Cette commande renvoie les ID de configuration de l'unité de composition et la nouvelle unité de composition créée pour l'actif dans la relation d'actif, tel qu'illustré dans l'exemple suivant :WebSphere:cuname=compositionUnit1 WebSphere:cuname=compositionUnit2 WebSphere:cuname=J2EEAsset
- Sauvegardez les modifications. Entrez l'exemple de commande suivante pour sauvegarder les modifications de configuration :
AdminConfig.save()
- Affichez les unités de composition et les paramètres de configuration.
Utilisez les commandes listCompUnits et viewCompUnits pour afficher les ID de configuration de chaque unité de composition qui correspond à une portée de recherche spécifique.
Vous pouvez utiliser la commande listCompUnits pour afficher chaque unité de composition dans votre configuration ou dans une application de niveau métier spécifique. L'exemple suivant affiche chaque unité de composition dans l'application de niveau métier myBLA :AdminTask.listCompUnits('-blaID blaname=myBLA')
La commande renvoie les ID de configuration et le type d'actif de renfort pour chaque unité de composition qui correspond à la portée de recherche, tel qu'illustré dans l'exemple suivant :Websphere:cuname=cu1 asset Websphere:cuname=cu4 bla WebSphere:cuname=defaultapp __j2ee
Vous pouvez utiliser la commande viewCompUnits pour afficher des informations de configuration complémentaires au sujet d'une unité de composition d'une application de niveau métier. Ainsi, l'exemple suivant affiche des informations complémentaires au sujet de l'unité de composition cu1 pour l'application de niveau métier myBLA :AdminTask.viewCompUnit('-blaID myBLA -cuID cu1')
La commande renvoie des informations de configuration détaillées au sujet de l'unité de composition, tel qu'illustré dans l'exemple suivant :Specify Composition Unit options (CUOptions) Specify name, description options for Composition Unit. Parent BLA (parentBLA): [WebSphere:blaname=myBLA] Backing Id (backingId): [WebSphere:assetname=asset1.zip] Name (name): [cu1] Description (description): [my description of cu1 composition unit] Starting Weight (startingWeight): [0] Specify servers (MapTargets) Specify targets such as application servers or clusters of application servers where you want to deploy the composition unit contained in the application. Deployable Unit (deplUnit): [default] *Servers (server): [WebSphere:node=myNode,server=server1] Specify Composition Unit activation plan options (ActivationPlanOptions) Specify composition unit activation plan optionsDeployableUnit Name (deplUnit): [default] Activation Plan (activationPlan): [WebSphere:specname=actplan0+WebSphere:specname=actplan1]
Si l'unité de composition contient un actif EBA (enterprise bundle archive), son statut s'affiche également. Le statut a l'une des valeurs suivantes :- Utilisation du dernier niveau de déploiement d'application OSGi.
- Nouveau déploiement d'application OSGi non disponible car les bundles requis sont encore en cours de téléchargement.
- Nouveau déploiement d'application OSGi disponible.
- Impossible d'appliquer le nouveau déploiement d'application OSGi car les téléchargements de bundle ont échoué.
- Editez les unités de composition.
- Démarrez l'outil de scriptage wsadmin.
- Modifiez l'unité de composition. Utilisez la commande editCompUnit pour modifier les options de l'unité de composition. Vous pouvez utiliser cette commande pour modifier le poids de départ de l'unité de composition, les cibles de déploiement, les options de plan d'activation et les paramètres de relation. Consultez la documentation du groupe de commandes BLAManagement pour l'objet AdminTask pour consulter des descriptions de chaque option que vous pouvez modifier.Remarque : Si l'unité de composition contient un actif EBA (enterprise bundle archive), il existe d'autres paramètres que vous pouvez modifier. Pour plus d'informations, voir Modification de la configuration d'une unité de composition OSGi à l'aide de la commande editCompUnit.Dans l'exemple suivant, une unité de composition, associée à un actif, est modifiée, pour ensuite remplacer la cible de déploiement :
AdminTask.editCompUnit('-blaID myBLA cuID cu1 CUOptions [[.* .* cu1 cudesc 1]] -MapTargets [[.* server2]] -ActivationPlanOptions [.* #specname=actplan0+specname=actplan2]')
La commande renvoie l'ID de configuration de l'unité de composition que le système édite, tel qu'illustré dans l'exemple suivant :WebSphere:cuname=cu1
- Sauvegardez les modifications. Entrez l'exemple de commande suivante pour sauvegarder les modifications de configuration :
AdminConfig.save()
- Supprimez les unités de composition.
- Démarrez l'outil de scriptage wsadmin.
- Supprimez les unités de composition. Utilisez la commande deleteCompUnit pour supprimer une unité de composition. Les deux paramètres de la commande suivante acceptent des ID de configuration incomplets, dans la mesure où le système peut mettre en correspondance la chaîne avec un ID unique :
AdminTask.deleteCompUnit('-blaID myBLA cuID cu1')
La commande renvoie l'ID de configuration de l'unité de composition que le système supprime, tel qu'illustré dans l'exemple suivant :WebSphere:cuname=cu1
- Sauvegardez les modifications. Entrez l'exemple de commande suivante pour sauvegarder les modifications de configuration :
AdminConfig.save()


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_7managecu
Nom du fichier : txml_7managecu.html