Scripts de configuration d'applications de niveau métier

La bibliothèque de scripts propose de nombreuses procédures de script pour automatiser la configuration des serveurs d'applications. Les scripts présentés dans cette rubrique permettent de créer, analyser et gérer vos applications de niveau métier. Vous pouvez exécuter chaque script individuellement ou combiner des procédures pour créer des scripts d'automatisation personnalisés.

Les procédures de script AdminBLA se trouvent dans le répertoire racine_serveur_app/scriptLibraries/application/V70.

Utilisez les procédures de script suivantes pour configurer et administrer vos applications de niveau métier :
Utilisez les procédures de script suivantes pour analyser les configurations de vos applications de niveau métier :
Eviter les incidents Eviter les incidents: Les commandes viewBLA, viewAsset, et viewCompUnit affichent uniquement la sortie sur la console et ne renvoient pas de données au script Jython appelant. Ces commandes ne sont pas conçues pour être utilisées dans le cadre d'un script pour stocker la sortie de la commande dans une variable de chaîne. Si vous utilisez ces commandes dans un script Jython pour stocker la sortie dans une variable de chaîne, la variable de chaîne contiendra uniquement la valeur "Operation Successful!".

Lorsqu'elles sont appelées comme prévu, avec l'interface wsadmin de Jython, ces commandes affichent correctement la sortie sur la console.

gotcha

addCompUnit

Ce script permet d'ajouter des actifs, des bibliothèques partagées ou des applications de niveau métier supplémentaires en tant qu'unités de composition dans une application de niveau métier vide. Une unité de composition représente un actif dans une application de niveau métier. Une unité de configuration permet au contenu de l'actif d'interagir avec d'autres actifs dans l'application. Elle permet aussi à l'environnement d'exécution du produit de charger et d'exécuter le contenu de l'actif.

Pour exécuter le script, spécifiez le nom de l'application de niveau métier ainsi que la source de l'unité de composition en tant qu'arguments, comme défini dans le tableau ci-après :
Tableau 1. Description des arguments de addCompUnit. Exécutez le script pour ajouter une unité de composition à une application de niveau métier.
Argument Description
blaName Indique le nom de l'application de niveau métier à laquelle le système ajoute une unité de composition.
compUnitID Indique le nom de l'unité de composition à ajouter à l'application de niveau métier qui vous intéresse.
deployableUnit Argument facultatif - Indique le nom de l'unité déployable caractéristique de l'actif. Une unité déployable correspond à la plus petite partie d'un actif qui peut être sélectionnée individuellement aux fins de déploiement.
compUnitName Argument facultatif - Indique le nom de l'unité de composition à ajouter.
compUnitDescription Argument facultatif - Donne une description de la nouvelle unité de composition.
startingWeight Argument facultatif - Indique la pondération de démarrage de l'unité de composition.
target Argument facultatif - Indique la cible à laquelle l'unité de composition est mappée.
activationPlan Argument facultatif - Indique le plan d'activation associé à l'unité de composition.

Syntaxe

AdminBLA.addCompUnit(blaName, compUnitID, deployableUnit, compUnitName,
 compUnitDescription, startingWeight, target, activationPlan)

Exemple de syntaxe

AdminBLA.addCompUnit("bla1", "asset1.zip", "default", "myCompositionUnit", "cu description", "1", 
"server1", "specname=actplan1")

createEmptyBLA

Ce script crée une nouvelle application de niveau métier dans votre environnement. Créez une application de niveau métier vide, puis ajoutez-lui des actifs, des bibliothèques partagées ou des applications de niveau métier en tant qu'unités de composition.

Pour exécuter le script, indiquez le nom de l'application de niveau métier en tant qu'argument, comme défini dans le tableau ci-après :
Tableau 2. Description des arguments de createEmptyBLA. Exécutez le script pour créer une application de niveau métier.
Argument Description
blaName Indique le nom à attribuer à la nouvelle application de niveau métier .
description Argument facultatif - Donne une description de l'application de niveau métier.

Syntaxe

AdminBLA.createEmptyBLA(blaName, description)

Exemple de syntaxe

AdminBLA.createEmptyBLA("myBLA", "bla to control transactions")

deleteAsset

Ce script supprime un actif enregistré de votre configuration.

Pour exécuter le script, indiquez l'ID de l'actif en tant qu'argument, comme défini dans le tableau ci-après :
Tableau 3. Description des arguments de deleteAsset. Exécutez le script pour supprimer un actif.
Argument Description
assetID Indique le nom de l'actif à supprimer.

Syntaxe

AdminBLA.deleteAsset(assetID)

Exemple de syntaxe

AdminBLA.deleteAsset("asset.zip")

deleteBLA

Ce script supprime une application de niveau métier de votre configuration.

Pour exécuter le script, indiquez le nom de l'application de niveau métier en tant qu'argument, comme défini dans le tableau ci-après :
Tableau 4. Description des arguments de deleteBLA. Exécutez le script pour supprimer une application de niveau métier.
Argument Description
blaName Indique le nom de l'application de niveau métier à supprimer.

Syntaxe

AdminBLA.deleteBLA(blaName)

Exemple de syntaxe

AdminBLA.deleteBLA("myBLA")

deleteCompUnit

Ce script supprime une unité de composition de la configuration d'une application de niveau métier spécifique.

Pour exécuter le script, spécifiez le nom de l'application de niveau métier ainsi que l'unité de composition en tant qu'arguments, comme défini dans le tableau ci-après :
Tableau 5. Description des arguments de deleteCompUnit. Exécutez le script pour supprimer une unité de composition d'une application de niveau métier.
Argument Description
blaName Indique le nom de l'application de niveau métier qui vous intéresse.
compUnitID Indique l'identificateur de l'unité de composition à supprimer.

Syntaxe

AdminBLA.deleteCompUnit(blaName, compUnitID)

Exemple de syntaxe

AdminBLA.deleteCompUnit("myBLA", "asset.zip")

editAsset

Ce script édite les métadonnées d'un actif spécifique enregistré.

Pour exécuter le script, spécifiez les arguments définis dans le tableau ci-après :
Tableau 6. Description des arguments de editAsset. Exécutez le script pour modifier un actif.
Argument Description
assetID Indique le nom de l'actif à éditer.
assetDescription Argument facultatif - Donne la nouvelle description de l'actif qui vous intéresse.
assetDestinationURL Argument facultatif - Indique la nouvelle URL de destination de l'actif qui vous intéresse.
assetTypeAspects Argument facultatif - Indique les nouveaux aspects du type d'actif qui vous intéresse.
assetRelationships Argument facultatif - Indique les nouvelles configurations de relation d'actif.
filePermission Argument facultatif - Indique la nouvelle configuration des permissions de fichier pour l'actif qui vous intéresse.
validateAsset Argument facultatif - Indique si la commande valide l'actif.

Syntaxe

AdminBLA.editAsset(assetID, assetDescription, assetDestinationURL, 
assetTypeAspects, assetRelationships, filePermission, validateAsset)

Exemple de syntaxe

AdminBLA.editAsset("asset1.zip", "asset for testing", "c:/installedAssets/asset1.zip", 
"WebSphere:spec=sharedlib", "", ".*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755", "true")

editCompUnit

Ce script édite une unité de composition spécifique dans une application de niveau métier.

Pour exécuter le script, spécifiez le nom de l'application de niveau métier ainsi que l'ID de l'unité de composition en tant qu'arguments, comme défini dans le tableau ci-après :
Tableau 7. Description des arguments de editCompUnit. Exécutez le script pour modifier une unité de composition.
Argument Description
blaName Indique le nom de l'application de niveau métier à laquelle l'unité de composition est associée.
compUnitID Indique le nom de l'unité de composition à éditer.
compUnitDescription Argument facultatif - Donne une nouvelle description de l'unité de composition.
startingWeight Argument facultatif - Indique la nouvelle pondération de démarrage pour l'unité de composition.
target Argument facultatif - Indique la nouvelle cible à laquelle l'unité de composition est mappée.
activationPlan Argument facultatif - Indique un nouveau plan d'activation pour l'unité de composition.

Syntaxe

AdminBLA.editCompUnit(blaName, compUnitID, compUnitDescription, 
startingWeight, target, activationPlan)

Exemple de syntaxe

AdminBLA.editCompUnit("bla1", "asset1.zip","cu description", "1", 
"server1", "specname=actplan1")

exportAsset

Ce script exporte un actif enregistré vers un fichier sur votre système.

Pour exécuter le script, spécifiez l'ID de l'actif le nom du fichier en tant qu'arguments, comme défini dans le tableau ci-après :
Tableau 8. Description des arguments de exportAsset. Exécutez le script pour exporter un actif.
Argument Description
assetID Indique l'identificateur de l'actif à exporter.
fileName Indique le chemin complet du fichier vers lequel le système exporte l'actif.

Syntaxe

AdminBLA.exportAsset(assetID, fileName)

Exemple de syntaxe

[Windows]
AdminBLA.exportAsset("asset.zip", "c:\temp\a.zip")
[AIX][Linux][Solaris][HP-UX][IBM i][z/OS]
AdminBLA.exportAsset("asset.zip", "/temp/a.zip")

importAsset

Ce script importe et enregistre un actif dans un domaine de gestion de votre configuration.

Pour exécuter le script, spécifiez les arguments assetID, displayDescription et deployableUnit, tels que définis dans le tableau ci-après :
Tableau 9. Description des arguments de importAsset. Exécutez le script pour importer un actif.
Argument Description
assetID Indique l'actif à importer.
displayDescription Argument facultatif - Indique si le script affiche la description de l'actif.
dispDeployableUnit Argument facultatif - Indique si le script affiche les unités déployables pour l'actif à importer.

Syntaxe

AdminBLA.importAsset(assetID, displayDescription, dispDeployableUnit)

Exemple de syntaxe

AdminBLA.importAsset("asset.zip", "true", "true")

startBLA

Ce script démarre le processus d'application de niveau métier dans votre configuration.

Pour exécuter le script, indiquez le nom de l'application de niveau métier en tant qu'argument, comme défini dans le tableau ci-après :
Tableau 10. Description des arguments de startBLA. Exécutez le script pour démarrer une application de niveau métier.
Argument Description
blaName Indique le nom de l'application de niveau métier à démarrer.

Syntaxe

AdminBLA.startBLA(blaName)

Exemple de syntaxe

AdminBLA.startBLA("myBLA")

stopBLA

Ce script arrête le processus d'application de niveau métier dans votre configuration.

Pour exécuter le script, indiquez le nom de l'application de niveau métier en tant qu'argument, comme défini dans le tableau ci-après :
Tableau 11. Description des arguments de stopBLA. Exécutez le script pour arrêter une application de niveau métier.
Argument Description
blaName Indique le nom de l'application de niveau métier à arrêter.

Syntaxe

AdminBLA.stopBLA(blaName)

Exemple de syntaxe

AdminBLA.stopBLA("myBLA")

help

Ce script affiche les procédures de script prises en charge par la bibliothèque de scripts AdminBLA. Pour accéder à l'aide détaillée d'un script spécifique, indiquez le nom du script qui vous intéresse, comme défini dans le tableau ci-après :
Tableau 12. Description des arguments de help. Exécutez le script pour afficher l'aide.
Argument Description
script Indique le nom du script qui vous intéresse.

Syntaxe

AdminBLA.help(script)

Exemple de syntaxe

AdminBLA.help("createEmptyBLA")

listAssets

Ce script affiche les actifs enregistrés dans votre configuration.

Pour exécuter le script, vous pouvez choisir d'indiquer l'ID de l'actif, d'afficher sa description et les unités déployables associées en tant qu'arguments, comme défini dans le tableau ci-après :
Tableau 13. Description des arguments de listAssets. Exécutez le script pour afficher la liste des actifs.
Argument Description
assetID Argument facultatif - Indique l'ID groupe pour lequel afficher les groupes d'autorisation.
displayDescription Argument facultatif - Indique si la commande affiche une description pour chaque actif. Spécifiez true pour afficher les descriptions.
displayDeployUnits Argument facultatif - Indique si la commande affiche les unités déployables associées aux actifs. Spécifiez true pour afficher les unités déployables.

Syntaxe

AdminBLA.listAssets(assetID, displayDescription, displayDeployUnits)

Exemple de syntaxe

AdminBLA.listAssets("asset.zip", "true", "true")

listBLAs

Ce script affiche toutes ou certaines applications de niveau métier spécifiques de votre configuration.

Pour exécuter le script, vous pouvez choisir d'indiquer le nom de l'application de niveau métier et d'afficher la description associée en tant qu'arguments, comme défini dans le tableau ci-après :
Tableau 14. Description des arguments de listBLAs. Exécutez le script pour afficher la liste des applications de niveau métier.
Argument Description
blaName Argument facultatif - Indique le nom de l'application de niveau métier qui vous intéresse.
displayDescription Argument facultatif - Indique si la commande affiche une description pour chaque application de niveau métier. Spécifiez true pour afficher les descriptions.

Syntaxe

AdminBLA.listBLAs(blaName, displayDescription)

Exemple de syntaxe

AdminBLA.listBLAs("", "true")

listCompUnits

Ce script affiche les unités de composition appartenant à une application de niveau métier.

Pour exécuter le script, indiquez le nom de l'application de niveau métier en tant qu'argument, comme défini dans le tableau ci-après :
Tableau 15. Description des arguments de listCompUnits. Exécutez le script pour afficher la liste des unités de composition.
Argument Description
blaName Indique le nom du groupe d'autorisations qui vous intéresse.
displayDescription Argument facultatif - Indique si la commande affiche une description pour chaque unité de composition. Spécifiez true pour afficher les descriptions.

Syntaxe

AdminBLA.listCompUnits(blaName, displayDescription)

Exemple de syntaxe

AdminBLA.listCompUnits("myBLA", "true")

viewBLA

Ce script affiche le nom et la description de l'application de niveau métier qui vous intéresse.

Pour exécuter le script, indiquez en tant qu'argument l'ID de configuration de cette application, comme défini dans le tableau ci-après :
Tableau 16. Description des arguments de viewBLA. Exécutez le script pour afficher les informations relatives à une application de niveau métier.
Argument Description
blaID Indique l'ID configuration de l'application de niveau métier qui vous intéresse.

Syntaxe

AdminBLA.viewBLA(blaID)

Exemple de syntaxe

AdminBLA.viewBLA("bla01.zip")

viewAsset

Ce script affiche les attributs de configuration d'un actif spécifique enregistré.

Pour exécuter le script, indiquez l'ID de l'actif en tant qu'argument, comme défini dans le tableau ci-après :
Tableau 17. Description des arguments de viewAsset. Exécutez le script pour visualiser les informations relatives à un actif.
Argument Description
assetID Indique le nom de l'actif qui vous intéresse.

Syntaxe

AdminBLA.viewAsset(assetID)

Exemple de syntaxe

AdminBLA.viewAsset("asset.zip")

viewCompUnit

Ce script affiche les attributs de configuration d'une unité de composition spécifique appartenant à une application de niveau métier.

Pour exécuter le script, spécifiez l'application de niveau métier ainsi que l'ID de l'unité de composition en tant qu'arguments, comme défini dans le tableau ci-après :
Tableau 18. Description des arguments de viewCompUnit. Exécutez le script pour visualiser les informations relatives à une unité de composition.
Argument Description
blaName Indique le nom de l'application de niveau métier qui vous intéresse.
compUnitID Indique l'identificateur de l'unité de composition qui vous intéresse.

Syntaxe

AdminBLA.viewCompUnit(blaName, compUnitID)

Exemple de syntaxe

AdminBLA.viewCompUnit("myBLA", "asset.zip")

Icône indiquant le type de rubrique Rubrique de référence



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=rxml_7libbla
Nom du fichier : rxml_7libbla.html