Vous pouvez créer une application de niveau métier vide, puis lui ajouter des actifs, des bibliothèques partagées ou d'autres applications de niveau métier comme unités de composition.
Avant de commencer
Pour créer une application de niveau métier, commencez par déterminer les actifs ou autres fichiers à ajouter à votre application.
Vérifiez également que le serveur d'applications cible est configuré. Dans le cadre de cette configuration, déterminez si vos fichiers d'application
peuvent s'exécuter sur vos cibles de déploiement.
Pourquoi et quand exécuter cette tâche
Vous pouvez utiliser l'outil wsadmin pour créer des applications de niveau métier dans votre environnement. Cette rubrique explique comment utiliser l'objet AdminTask pour importer et enregistrer des actifs, créer des applications de niveau métier vides et ajouter des actifs à l'application de niveau métier en tant qu'unités de composition. Vous pouvez aussi utiliser les scripts de la bibliothèque de scripts AdminBLA pour configurer et administrer les applications de niveau métier.
Procédure
- Démarrez l'outil de scriptage wsadmin.
- Importez des actifs dans votre configuration.
Les actifs représentent les fichiers binaires d'applications
qui contiennent la logique métier exécutée dans l'environnement d'exécution cible et qui traite les demandes des clients. Un actif peut contenir une archive de fichiers comme un fichier compressé (zip) ou un fichier JAR (Java™ archive), ou une archive de fichiers d'archive comme un fichier EAR
(archive d'entreprise) Java EE (Java Platform, Enterprise Edition). Des exemples d'actifs incluent des fichiers EAR,
des fichiers JAR de bibliothèque partagée et des assistants personnalisés pour des serveurs proxy.
Utilisez la commande
importAsset pour importer des actifs dans le référentiel de configuration du serveur d'application.
Consultez la documentation du groupe de commandes BLAManagement
de l'objet AdminTask pour découvrir d'autres options concernant le paramétrage et les étapes.
Dans cet exemple, les commandes permettent d'ajouter trois actifs au référentiel d'actifs.
Deux de ces actifs sont des actifs non-Java EE et l'un est un actif d'entreprise. La commande suivante permet d'importer l'actif asset1.zip dans le référentiel d'actifs et attribue à l'ID de configuration renvoyé, la valeur de la variable asset1 :
asset1 = AdminTask.importAsset('-source c:/ears/asset1.zip')
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[HP-UX]](../images/hpux.gif)
![[AIX]](../images/aixlogo.gif)
![[IBM i]](../images/iseries.gif)
asset1 = AdminTask.importAsset('-source /ears/asset1.zip')
La commande suivante permet de n'importer que les métadonnées de l'actif asset2.zip,
attribue à l'actif le nom testAsset.zip, définit le répertoire de déploiement, indique que l'actif est utilisé à des fins de test et attribue à l'ID de configuration renvoyé la valeur de la variable testasset :
testasset = AdminTask.importAsset('-source c:/ears/asset2.zip -storageType METADATA
–AssetOptions [[.* testAsset.zip .* "asset for testing"
c:/installedAssets/testAsset.zip/BASE/testAsset.zip "" "" "" false]]')
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[HP-UX]](../images/hpux.gif)
![[AIX]](../images/aixlogo.gif)
![[IBM i]](../images/iseries.gif)
testasset = AdminTask.importAsset('-source /ears/asset2.zip -storageType METADATA
–AssetOptions [[.* testAsset.zip .* "asset for testing"
/installedAssets/testAsset.zip/BASE/testAsset.zip "" "" "" false]]')
La commande suivante permet d'importer l'actif defaultapp.ear, en stockant tous les fichiers binaires d'application, et attribue à l'ID de configuration renvoyé la valeur de la variable J2EEAsset :
J2EEAsset = AdminTask.importAsset('-source c:/ears/defaultapplication.ear
–storageType FULL –AssetOptions [[.* defaultapp.ear .* "desc" "" "" "" "" false]]')
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[HP-UX]](../images/hpux.gif)
![[AIX]](../images/aixlogo.gif)
![[IBM i]](../images/iseries.gif)
J2EEAsset = AdminTask.importAsset('-source /ears/defaultapplication.ear
–storageType FULL –AssetOptions [[.* defaultapp.ear .* "desc" "" "" "" "" false]]')
Les actifs qui vous intéressent sont enregistrés en tant qu'artefacts de configuration nommés dans le référentiel de configuration du serveur d'applications, que l'on appelle alors registre des actifs. Utilisez la commande
listAssets pour afficher une liste des actifs enregistrés et vérifier que les paramètres sont corrects, tel qu'illustré dans l'exemple suivant :
AdminTask.listAssets('-includeDescription true -includeDeplUnit true')
- Créez une application de niveau métier vide.
Utilisez la commande
createEmptyBLA pour créer une nouvelle application de niveau métier et attribuer
à l'ID de configuration renvoyé la valeur de la variable
myBLA, tel qu'illustré dans l'exemple suivant :
myBLA = AdminTask.createEmptyBLA('-name myBLA
-description "BLA that contains asset1, asset2, and J2EEAsset"')
Le système crée alors l'application de niveau métier. Utilisez la commande
listBLAs pour afficher une liste de chaque application de niveau métier dans la cellule, tel qu'illustré dans l'exemple suivant :
AdminTask.listBLAs()
- Ajoutez les actifs, en tant qu'unités de composition, à l'application de niveau métier.
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 sur des environnements d'exécution non-Websphere Application Server, sans actifs de renfort.
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.
Utilisez
la commande
addCompUnit pour ajouter des unités de composition à des applications de niveau métier. La commande suivante permet d'ajouter l'actif
asset1.zip en tant qu'unité de composition dans l'application de niveau métier
myBLA et de 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]]')
La commande suivante ajoute l'actif
testAsset.zip en tant qu'unité de composition dans l'application de niveau métier
myBLA et mappe 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]')
La commande suivante ajoute l'actif
defaultapp.ear en tant qu'unité de composition dans l'application de niveau métier
myBLA et mappe le déploiement vers les serveurs
server1 et
testServer :
AdminTask.addCompUnit('[-blaID bla1 -cuSourceID ' + J2EEAsset + ' -defaultBindingOptions
defaultbinding.ejbjndi.prefix=ejb#defaultbinding.virtual.host=default_host#defaultbinding.force=yes
-AppDeploymentOptions [-appname defaultapp] -MapModulesToServers [["Default Web Application" .*
WebSphere:cell=cellName,node=nodeName,server=server1] ["Increment EJB module" .*
Websphere:cell=cellName,node=nodeName,server=testServer]]
-CtxRootForWebMod [["Default Web Application" .* myctx/]]]')
- Sauvegardez les modifications.
Entrez l'exemple de commande suivante pour sauvegarder les modifications de
configuration :
AdminConfig.save()
- Synchroniser les noeuds.
Utilisez le script syncActiveNodes
de la bibliothèque de scripts AdminNodeManagement pour synchroniser chaque noeud actif de votre environnement, tel qu'illustré dans l'exemple suivant :
AdminNodeManagement.syncActiveNodes()
- Démarrez l'application de niveau métier.
Utilisez la commande
startBLA
pour démarrer chaque unité de composition de l'application de niveau métier sur les cibles de déploiement,
pour lesquelles les unités de composition sont configurées, tel qu'illustré dans l'exemple suivant :
AdminTask.startBLA('-blaID myBLA')
Résultats
Le système ajoute trois unités de composition ayant comme renforts des actifs à une nouvelle application de niveau métier. Chacun des trois actifs est déployé et démarré sur le serveur server1. Les actifs testAsset.zip et defaultapp.ear
sont également déployés et démarrés sur le serveur testServer.