Définition d'applications de niveau métier à l'aide de l'outil de scriptage wsadmin

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

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

    [Windows]
    asset1 = AdminTask.importAsset('-source c:/ears/asset1.zip')
    [Linux][Solaris][HP-UX][AIX][IBM i][z/OS]
    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 :

    [Windows]
    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][Solaris][HP-UX][AIX][IBM i][z/OS]
    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 :

    [Windows]
    J2EEAsset = AdminTask.importAsset('-source c:/ears/defaultapplication.ear 
     –storageType FULL –AssetOptions [[.* defaultapp.ear .* "desc" "" "" "" "" false]]')
    [Linux][Solaris][HP-UX][AIX][IBM i][z/OS]
    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')
  3. 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()
  4. 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 serveurserver1 :
    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/]]]')
  5. Sauvegardez les modifications.
    Entrez l'exemple de commande suivante pour sauvegarder les modifications de configuration :
    AdminConfig.save()
  6. 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()
  7. 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.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_7createbla
Nom du fichier : txml_7createbla.html