Options des commandes install, installInteractive, edit, editInteractive, update et updateInteractive de l'objet AdminApp avec les outils de script de wsadmin
La présente rubrique répertorie les options disponibles pour les commandes install, installInteractive, edit, editInteractive, update et updateInteractive de l'objet AdminApp.
Vous pouvez utiliser les commandes de l'objet AdminApp pour installer, éditer, mettre à jour et gérer les configurations de vos applications. Cette rubrique propose des options supplémentaires pour les commandes install, installInteractive, edit, editInteractive, update et updateInteractive pour administrer les applications. Sauf indication contraire, les options indiquées dans cette rubrique s'appliquent à toutes les commandes mentionnées ci-dessus.
Vous pouvez paramétrer ou mettre à jour une valeur de configuration à l'aide des options en mode de traitement par lots. Pour identifier l'objet de configuration à paramétrer ou mettre à jour, les valeurs des zones de lecture seule sont utilisées pour trouver l'objet de configuration correspondant. Toutes les valeurs des zones de lecture seule doivent correspondre à un objet de configuration existant, sinon la commande échoue.
Vous pouvez utiliser la reconnaissance de masques pour simplifier la tâche de spécification des valeurs requises pour certaines options complexes. La reconnaissance de masques ne s'applique qu'aux champs requis ou en lecture seule.
- ActSpecJNDI
- allowDispatchRemoteInclude
- allowPermInFilterPolicy
- allowServiceRemoteInclude
- appname
- BackendIdSelection
- BindJndiForEJBBusiness
- BindJndiForEJBMessageBinding
- BindJndiForEJBNonMessageBinding
- blaname
- buildVersion
- cellule
- clientMode
- cluster
- contents
- contenturi
- contextroot
- CorrectOracleIsolationLevel
- CorrectUseSystemIdentity
- createMBeansForResources
- CtxRootForWebMod
- custom
- CustomActivationPlan
- DataSourceFor10CMPBeans
- DataSourceFor20CMPBeans
- DataSourceFor10EJBModules
- DataSourceFor20EJBModules
- defaultbinding.cf.jndi
- defaultbinding.cf.resauth
- defaultbinding.datasource.jndi
- defaultbinding.datasource.password
- defaultbinding.datasource.username
- defaultbinding.ee.defaults
- defaultbinding.ejbjndi.prefix
- defaultbinding.force
- defaultbinding.strategy.file
- defaultbinding.virtual.host
- depl.extension.reg (obsolète)
- deployejb
- deployejb.classpath
- deployejb.complianceLevel
- deployejb.dbschema
- deployejb.dbtype
- deployejb.dbaccesstype
- deployejb.rmic
- deployejb.sqljclasspath
- deployws
- deployws.classpath
- deployws.jardirs
- distributeApp
- EmbeddedRar
- enableClientModule
- EnsureMethodProtectionFor10EJB
- EnsureMethodProtectionFor20EJB
- filepermission
- installdir (déconseillé)
- installed.ear.destination
- JSPCompileOptions
- JSPReloadForWebMod
- MapEJBRefToEJB
- MapEnvEntryForApp
- MapEnvEntryForClientMod
- MapEnvEntryForEJBMod
- MapEnvEntryForWebMod
- MapInitParamForServlet
- MapJaspiProvider
- MapMessageDestinationRefToEJB
- MapModulesToServers
- MapResEnvRefToRes
- MapResRefToEJB
- MapRolesToUsers
- MapRunAsRolesToUsers
- MapSharedLibForMod
- MapWebModToVH
- MetadataCompleteForModules
- ModuleBuildID
- noallowDispatchRemoteInclude
- noallowPermInFilterPolicy
- noallowServiceRemoteInclude
- noeud
- nocreateMBeansForResources
- nodeployejb
- nodeployws
- nodistributeApp
- noenableClientModule
- noreloadEnabled
- nopreCompileJSPs
- noprocessEmbeddedConfig
- nouseAutoLink
- nouseMetaDataFromBinary
- nousedefaultbindings
- novalidateSchema
- operation
- processEmbeddedConfig
- preCompileJSPs
- reloadEnabled
- reloadInterval
- SharedLibRelationship
- server
- target
- update
- update.ignore.new
- update.ignore.old
- useAutoLink
- usedefaultbindings
- useMetaDataFromBinary
- validateinstall
- validateSchema
- verbose
- WebServicesClientBindDeployedWSDL
- WebServicesClientBindPortInfo
- WebServicesClientBindPreferredPort
- WebServicesServerBindPort
- WebServicesClientCustomProperty
- WebServicesServerCustomProperty
ActSpecJNDI
- RARModule : <nom module rar>
- uri : <nom rar>,META-INF/ra.xml
- ID objet : <messageListenerType>
- Nom JNDI : null
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install $embeddedEar {-ActSpecJNDI
{{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener jndi5}
{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener2 jndi6}}}
$AdminApp install $embeddedEar {-ActSpecJNDI
{{.* .*.rar,.* javax.jms.MessageListener jndi5}
{.* .*.rar,.* javax.jms.MessageListener2 jndi6}}}
AdminApp.install(embeddedEar, ['-ActSpecJNDI',
[["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener', 'jndi5'],
["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener2', 'jndi6']]])
AdminApp.install(embeddedEar, ['-ActSpecJNDI',
[['.*', '.*.rar,.*', 'javax.jms.MessageListener', 'jndi5'],
['.*', '.*.rar,.*', 'javax.jms.MessageListener2', 'jndi6']]])
allowDispatchRemoteInclude
L'option allowDispatchRemoteInclude permet à une application d'entreprise de distribuer des demandes d'inclusion à des ressources entre des modules Web qui se trouvent dans des machines virtuelles Java différentes, dans un environnement de noeud géré par le biais du répartiteur de demandes standard.
Exemple d'utilisation en mode de traitement par lots
set deployments [$AdminConfig getid /Deployment:RRDEnabledAppname/]
set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]
set rrdAttr [list allowDispatchRemoteInclude true]
set attrs [list $rrdLocalAttr]
$AdminConfig modify $deploymentObject $attrs
deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute (deployments, 'deployedObject')
rrdAttr = ['allowDispatchRemoteInclude', 'true']
attrs = [rrdLocalAttr]
AdminConfig.modify (deploymentObject, attrs)
allowPermInFilterPolicy
L'option allowPermInFilterPolicy indique que le processus du déploiement d'application doit continuer, même si l'application contient des droits basés sur des règles, qui se trouvent dans les règles de filtrage. Cette option ne nécessite pas de valeur.
allowServiceRemoteInclude
L'option allowServiceRemoteInclude permet à une application d'entreprise d'initier une demande d'inclusion à partir d'une application d'entreprise dont l'option allowDispatchRemoteInclude a la valeur true.
Exemple d'utilisation en mode de traitement par lots
set deployments [$AdminConfig getid /Deployment:RRDEnabledAppname/]
set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]
set rrdAttr [list allowServiceRemoteInclude true]
set attrs [list $rrdAttr]
$AdminConfig modify $deploymentObject $attrs
deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute ('deployments', 'deployedObject')
rrdAttr = ['allowServiceRemoteInclude', 'true']
attrs = [rrdAttr]
AdminConfig.modify (deploymentObject, attrs)
appname
L'option appname indique le nom de l'application. La valeur par défaut est le nom affiché de l'application.
BackendIdSelection
L'option BackendIdSelection indique l'ID dorsal pour les modules JAR (Java archive) de bean enterprise contenant des beans à persistance gérée par conteneur (CMP). Un module JAR de bean enterprise peut prendre en charge plusieurs configurations de dorsal selon les indications à l'aide d'un outil d'assemblage d'application. Utilisez cette option pour modifier l'ID dorsal lors de l'installation.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install myapp.ear {-BackendIdSelection
{{Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml DB2UDBNT_V72_1}}}
$AdminApp install myapp.ear {-BackendIdSelection
{{.* Annuity20EJB.jar,.* DB2UDBNT_V72_1}}}
AdminApp.install('myapp.ear', '[-BackendIdSelection
[[Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml DB2UDBNT_V72_1]]]')
AdminApp.install('myapp.ear', ['-BackendIdSelection',
[['.*', 'Annuity20EJB.jar,.*', 'DB2UDBNT_V72_1']]])
BindJndiForEJBBusiness
L'option BindJndiForEJBBusiness lie avec des noms JNDI des modules EJB à interfaces métier. Chacun de ces modules EJB doit être lié à un nom JNDI.
- Module : Ejb1
- Bean : MessageBean
- URI : sample.jar,META-INF/ejb-jar.xml
- Interface métier : com.ibm.sample.business.bnd.LocalTargetOne
- Nom JNDI : []: ejblocal:ejb/LocalTargetOne
Si vous spécifiez le nom JNDI de la ressource cible avec l'option BindJndiForEJBNonMessageBinding, ne spécifiez pas de nom JNDI d'interface métier dans l'option BindJndiForEJBBusiness. Si vous ne spécifiez pas de nom JNDI pour la ressource cible, spécifiez un nom JNDI d'interface métier. Si vous ne spécifiez aucun nom JNDI d'interface métier, l'environnement d'exécution fournit un conteneur par défaut.
Pour une vue sans interface, la valeur de l'interface métier est une chaîne vide ("").
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install $ear {-BindJndiForEJBBusiness {{ ejb_1.jar ejb1
ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 }}}
$AdminApp install $ear {-BindJndiForEJBBusiness {{ .* .* .*.jar,.* test.ejb1 jndi1 }}}
AdminApp.install(ear, '[-BindJndiForEJBBusiness [[ejb_1.jar ejb1
ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 ]]]')
AdminApp.install(ear, '[-BindJndiForEJBBusiness [[.* .* .*.jar,.* test.ejb1 jndi1]]]')
BindJndiForEJBMessageBinding
L'option BindJndiForEJBMessageBinding lie les beans enterprise gérés par message à des noms de port d'écoute ou à des noms JNDI (Java Naming and Directory Interface) de spécification d'activation. Utilisez cette option pour indiquer des données manquantes ou mettre à jour une tâche. Lorsqu'un bean MDB est lié à un nom JNDI de spécification d'activation, vous pouvez également indiquer l'alias d'authentification et le nom JNDI de la destination.
Chaque élément de l'option BindJndiForEJBMessageBinding comprend les zones suivantes : EJBModule, EJB, uri, listenerPort, JNDI, jndi.dest et actspec.auth. Certaines zones peuvent recevoir des valeurs : listenerPort, JNDI, jndi.dest et actspec.auth.
- Module : Ejb1
- Bean : MessageBean
- URI : ejb-jar-ic.jar,META-INF/ejb-jar.xml
- Port d'écoute : [null]:
- Nom JNDI : [eis/MessageBean]:
- Nom JNDI de destination : [jms/TopicName]:
- Alias d'authentification ActivationSpec : [null]:
Si une propriété de configuration d'activation destinationLookup n'est pas fournie en tant qu'annotation ni dans un descripteur de déploiement et qu'un nom JNDI de destination ne figure pas dans le fichier de liaison IBM, le nom JNDI de destination par défaut est collecté à partir de la référence de message correspondante.
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install $ear {-BindJndiForEJBMessageBinding {{Ejb1 MessageBean
ejb-jar-ic.jar,META-INF/ejb-jar.xml myListenerPort jndi1 jndiDest1 actSpecAuth1}}}
$AdminApp install $ear {-BindJndiForEJBMessageBinding {{.* .*
.*.jar,.* myListenerPort jndi1 jndiDest1 actSpecAuth1}}}
AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
[['Ejb1', 'MessageBean', 'ejb-jar-ic.jar,META-INF/ejb-jar.xml', 'myListenerPort',
'jndi1', 'jndiDest1', 'actSpecAuth1']]])
AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
[['.*', '.*', '.*.jar,.*', 'myListenerPort', 'jndi1', 'jndiDest1', 'actSpecAuth1']]])
BindJndiForEJBNonMessageBinding
L'option BindJndiForEJBNonMessageBinding lie les beans enterprise à des noms JNDI (Java Naming and Directory Interface). Veillez à ce que chaque bean enterprise géré par messages de votre application ou module soit lié à un nom JNDI. Utilisez cette option pour indiquer des données manquantes ou mettre à jour une tâche.
- Module : Ejb1
- Bean : MessageBean
- URI : ejb-jar-ic.jar,META-INF/ejb-jar.xml
- Nom JNDI de la ressource cible : [com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC]
- Nom JNDI home local : [null]
- Nom JNDI home distant : [null]
Il existe des contraintes spéciales pour les modules Enterprise JavaBeans (EJB) versions 3.0 et ultérieures. Si vous spécifiez le nom JNDI de la ressource cible, ne spécifiez pas de nom JNDI pour les interfaces home locale ou distante. Vous ne pouvez pas non plus spécifier de JNDI pour la zone interfaces métier de l'option BindJndiForEJBBusiness option. Si vous ne spécifiez pas de nom JNDI pour la ressource cible, les zones de noms JNDI pour les interfaces home d'interface ne sont pas obligatoires. Si vous ne spécifiez pas de nom JNDI pour les interfaces home locale et distante, le module d'exécution fournira un conteneur par défaut.
Si vous n'utilisez pas de modules EJB 3.0, vous devez spécifier le nom JNDI pour la ressource cible.
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
![[Windows]](../images/windows.gif)
$AdminApp install c:/myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean
ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""}}}
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$AdminApp install /myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean
ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""}}}
$AdminApp install app_server_rootapps/myapps/installableApps/JobbankTargetEJBApp.ear
{-BindJndiForEJBNonMessageBinding {{.* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
ejb/com/app/ResumeBank/ResumeBank "" "" }}}
En langage Jython :
![[Windows]](../images/windows.gif)
AdminApp.install('C:/myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean
ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.install('myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean
ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')
AdminApp.install('app_server_root/apps/myapps/installableApps/JobbankTargetEJBApp.ear',
'[ -BindJndiForEJBNonMessageBinding [[ .* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
ejb/com/app/ResumeBank/ResumeBank "" "" ]] ]' )
blaname
L'option blaname permet de spécifier le nom de l'application de niveau métier sous laquelle le système crée l'application Java EE. Cette option est facultative. Si vous ne spécifiez pas de valeur, le système définit lui-même le nom de l'application Java EE. Cette option n'est disponible qu'avec la commande install.
buildVersion
L'option buildVersion affiche la version de compilation d'un fichier EAR d'application. Vous ne pouvez pas modifier cette option car elle est en lecture seule. Cette option renvoie les informations de version de compilation d'un EAR d'application si vous avez spécifié cette version dans le fichier EAR MANIFEST.MF de l'application.
cellule
L'option cell spécifie le nom de la cellule dans laquelle installer ou actualiser une application entière, ou dans laquelle mettre à jour une application afin d'ajouter un nouveau module. Si vous souhaitez mettre à jour une application entière, cette option ne s'applique que si l'application contient un nouveau module qui n'existe pas dans l'application d'installation.
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
![[Windows]](../images/windows.gif)
$AdminApp install "C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$AdminApp install "/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}
En langage Jython :
![[Windows]](../images/windows.gif)
AdminApp.install('C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.install('/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')
clientMode
L'option clientMode indique si des modules client doivent être déployés sur une cible de déploiement isolée (isolé), un noeud fédéré d'un gestionnaire de déploiement, (fédéré) ou un serveur d'applications (déployé sur le serveur). Si vous indiquez cette option, vous installez les modules client uniquement sur une cible de déploiement version 8.0 ou version ultérieure.
La valeur par défaut est isolé.
Le choix du mode de déploiement du client affecte le traitement des recherches java:. Tous les espaces de noms d'URL Java (global, application, module et composant) sont des noms locaux dans les processus client isolés. Les espaces de noms résident sur un serveur dans des processus client de type Serveur déployé et Fédéré. Le serveur ou cluster choisi comme cible d'un module client détermine l'endroit où ces espaces de noms sont créés. Toutes les recherches java: des modules client de type Serveur déployé ou Fédéré sont redirigées vers le serveur ou cluster cible. Le module client ne s'exécute pas vraiment dans le serveur ou cluster cible. Plusieurs instances du même module client partagent le même espace de noms de composant dans les modes Fédéré et Serveur déployé. Le choix du mode Fédéré revient à déclarer que vous avez l'intention de lancer le module client à l'aide de JNLP (Java Network Launching Protocol), mais les mécanismes JNDI (Java Naming and Directory Interface) des modes Fédéré et Serveur déployé sont identiques.
cluster
L'option cluster spécifie le nom de cluster dans lequel installer ou mettre à jour une application entière, ou mettre à jour une application afin d'ajouter un nouveau module. Cette option ne s'applique que dans un environnement WebSphere Application Server, Network Deployment. Si vous souhaitez mettre à jour une application entière, cette option ne s'applique que si l'application contient un nouveau module qui n'existe pas dans l'application d'installation. Vous ne pouvez pas utiliser ensemble les options -cluster et -server.
Si vous souhaitez déployer une application et spécifier le serveur HTTP lors du déploiement, afin que l'application apparaisse dans le fichier plugin-cfg.xml généré, vous devez d'abord installer l'application avec une cible de -cluster. Une fois que vous avez installé l'application, et avant d'enregistrer les changements, utilisez la commande edit de l'objet AdminApp pour ajouter le mappage supplémentaire au serveur Web.
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
![[Windows]](../images/windows.gif)
$AdminApp install "C:/myapp.ear" {-cluster clusterName}
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$AdminApp install "myapp.ear" {-cluster clusterName}
En langage Jython :
![[Windows]](../images/windows.gif)
AdminApp.install('C:/myapp/myapp.ear', '[-cluster clusterName]')
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.install('/myapp/myapp.ear', '[-cluster clusterName]')
contents
L'option contents indique le fichier stockant le contenu à mettre à jour. Par exemple, en fonction du type de contenu, le fichier peut être un fichier EAR, un module, un fichier zip partiel ou un fichier unique. Le chemin du fichier doit être défini en local par rapport au client de scriptage. L'optioncontents est obligatoire sauf si vous avez indiqué l'option delete.
contenturi
L'option contenturi indique l'identificateur URI du fichier que vous ajoutez, mettez à jour ou supprimez de l'application. Cette option s'applique uniquement à la commande update. L'option contenturi est obligatoire si le type de contenu est file ou modulefile. Cette option est ignorée pour les autres types de contenu.
contextroot
L'option contextroot indique la racine de contexte à utiliser pour installer un fichier WAR d'application Web autonome.
CorrectOracleIsolationLevel
L'option CorrectOracleIsolationLevel indique le niveau d'isolement du fournisseur de type Oracle. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour. La dernière zone des entrées correspond au niveau d'isolement. Les valeurs de niveau d'isolement admises sont 2 ou 4.
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous n'avez à fournir que des données pour les lignes ou que les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install myapp.ear {-CorrectOracleIsolationLevel
{{AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2}}
$AdminApp install myapp.ear {-CorrectOracleIsolationLevel
{{.* jms/MyQueueConnectionFactory jms/Resource1 2}}
AdminApp.install('myapp.ear', '[-CorrectOracleIsolationLevel
[[AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2]]]')
AdminApp.install('myapp.ear', ['-CorrectOracleIsolationLevel',
[['.*', 'jms/MyQueueConnectionFactory', 'jms/Resource1', 2]]])
CorrectUseSystemIdentity
L'option CorrectUseSystemIdentity remplace le système RunAs par des rôles RunAs. Les beans enterprise que vous installez contiennent une identité système RunAs. Vous pouvez éventuellement changer cette identité en rôle RunAs. Utilisez cette option pour indiquer des données manquantes ou mettre à jour une tâche.
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install myapp.ear {-CorrectUseSystemIdentity {{Inc "Increment Bean Jar"
Increment.jar,META-INF/ejb-jar.xml getValue() RunAsUser2 user2 password2}
{Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml Increment()
RunAsUser2 user2 password2}}}
$AdminApp install myapp.ear {-CorrectUseSystemIdentity
{{.* .* .* getValue() RunAsUser2 user2 password2}
{.* .* .* Increment() RunAsUser2 user2 password2}}}
AdminApp.install('myapp.ear', '[-CorrectUseSystemIdentity
[[Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml getValue()
RunAsUser2 user2 password2]
[Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml Increment()
RunAsUser2 user2 password2]]]')
AdminApp.install('myapp.ear', ['-CorrectUseSystemIdentity',
[['.*', '.*', '.*', 'getValue()', 'RunAsUser2', 'user2', 'password2'],
['.*', '.*', '.*', 'Increment()', 'RunAsUser2', 'user2', 'password2']]])
createMBeansForResources
L'option createMBeansForResources indique que des beans gérés sont créés pour tous les actifs (servlets, fichiers JSP et beans enterprise) définis dans une application lorsque l'application démarre sur une cible de déploiement. Cette option ne nécessite pas de valeur. Le réglage par défaut est l'option nocreateMBeansForResources.
CtxRootForWebMod
- Module Web : xxx
- URI : xxx
- Racine de contexte : <racine de contexte>
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/ivtApp.ear
{-appname ivtApp -CtxRootForWebMod
{{"IVT Application" ivt_app.war,WEB-INF/web.xml /mycontextroot}}}
$AdminApp install myapp.ear {-appname MyApp -CtxRootForWebMod {{.* .* /mycontextroot}}}
En langage Jython :
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
['-appname', 'ivtApp ', '-CtxRootForWebMod',
[["IVT Application", 'ivt_app.war,WEB-INF/web.xml', '/mycontextroot']]])
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-CtxRootForWebMod',
[['.*', '.*', '/mycontextroot']]])
custom
L'option custom indique une paire nom/valeur selon le format nom=valeur. Utilisez l'option custom pour transmettre les options aux extensions de déploiement de l'application. Pour connaître les options disponibles, consultez la documentation de l'extension de déploiement de l'application.
CustomActivationPlan
L'option CustomActivationPlan indique les composants d'exécution à ajouter ou à supprimer des composants par défaut utilisés pour exécuter l'application. N'utilisez cette option que lorsque le serveur d'applications ne peut pas obtenir tous les composants d'exécution nécessaires en inspectant l'application.
Exemple d'utilisation en mode de traitement par lots
AdminApp.install('Increment.jar','[-CustomActivationPlan [["Increment Enterprise Java Bean"
Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')
AdminApp.install('Increment.jar','[-CustomActivationPlan [[.*
Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')
Composant | Valeur de WS_ComponentToAdd |
---|---|
Conteneur EJB | WS_EJBContainer |
Conteneur de portlet | WS_PortletContainer |
JavaServer Faces (JSF) | WS_JSF |
Conteneur SIP | WS_SipContainer |
Portée du service de compensation | WS_Compensation |
Profil d'application | WS_AppProfile |
Session d'activité | WS_ActivitySession |
Internationalisation | WS_I18N |
Beans de démarrage | WS_StartupService |
DataSourceFor10CMPBeans
L'option DataSourceFor10CMPBeans indique les sources de données facultatives pour les beans CMP 1.x individuels. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.
Lorsqu'une source de données spécifique est mappée vers un bean CMP, elle remplace la source de données par défaut pour le module qui contient le bean enterprise. Chaque élément de l'option DataSourceFor10CMPBeans comprend les zones suivantes : EJBModule, EJB, uri, JNDI, userName, password, login.config.name et auth.props. Parmi ces zones, les zones JNDI, userName, password, login.config.name et auth.props peuvent être associées à des valeurs.
- Module : Increment CMP 1.1 EJB
- Bean : IncCMP11
- URI : IncCMP11.jar,META-INF/ejb-jar.xml
- Nom JNDI de la ressource cible : [DefaultDatasource]:
- Nom d'utilisateur : [null]:
- Mot de passe : [null]:
- Nom de configuration de connexion : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
- Propriétés : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
Si login.config.name prend la valeur DefaultPrincipalMapping, une propriété est créée avec le nom com.ibm.mapping.authDataAlias. La valeur de la propriété est définie par auth.props. Si le nom login.config ne prend pas la valeur DefaultPrincipalMapping, auth.props peut spécifier plusieurs propriétés. Le format de chaîne est websphere:name= <name1>,value=<value1>,description=<desc1>. Spécifiez plusieurs propriétés à l'aide du signe "+".
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
![[Windows]](../images/windows.gif)
$AdminApp install C:/app1.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB"
IncCMP11 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}}
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB" IncCMP11
IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}}
En langage Jacl avec appariement de formes :
![[Windows]](../images/windows.gif)
$AdminApp install C:/myapp.ear {-DataSourceFor10CMPBeans {{.* .*
IncCMP11.jar,.* myJNDI user1 password1 loginName1 authProps1}}}
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{.* .* IncCMP11.jar,.*
myJNDI user1 password1 loginName1 authProps1}}}
En langage Jython :
![[Windows]](../images/windows.gif)
AdminApp.install('C:/app1.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1', 'password1',
'loginName1', 'authProps1']]])
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1',
'password1', 'loginName1', 'authProps1']]])
Avec Jython avec appariement de formes :
![[Windows]](../images/windows.gif)
AdminApp.install('C:/myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*',
'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*',
'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])
DataSourceFor20CMPBeans
L'option DataSourceFor20CMPBeans indique les sources de données facultatives pour les beans CMP 2.x individuels. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.
Lorsqu'une source de données spécifique est mappée vers un bean CMP, elle remplace la source de données par défaut pour le module qui contient le bean enterprise. Chaque élément de l'option DataSourceFor20CMPBeans comprend les zones suivantes EJBModule, EJB, uri, JNDI, resAuth, login.config.name et auth.props. Parmi ces zones, les zones JNDI, resAuth, login.config.name et auth.props peuvent être associées à des valeurs.
- Module : Increment enterprise bean
- Bean : Increment
- URI: Increment.jar,META-INF/ejb-jar.xml
- Nom JNDI de la ressource cible : [null]:
- Autorisation ressources : [par application]:
- Nom de configuration de connexion : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
- Propriétés : [] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
Si login.config.name prend la valeur DefaultPrincipalMapping, une propriété est créée avec le nom com.ibm.mapping.authDataAlias. La valeur de la propriété est définie par auth.props. Si le nom login.config ne prend pas la valeur DefaultPrincipalMapping, auth.props peut spécifier plusieurs propriétés. Le format de chaîne est websphere:name= <name1>,value=<value1>,description=<desc1>. Spécifiez plusieurs propriétés à l'aide du signe "+".
Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp. Vous n'avez à fournir que des données pour les lignes ou que les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install Increment.jar {-DataSourceFor20CMPBeans
{{"Increment Enterprise Java Bean" Increment
Increment.jar,META-INF/ejb-jar.xml jndi1 container "" ""}}}
$AdminApp install Increment.jar {-DataSourceFor20CMPBeans {{.* .*
Increment.jar,.* jndi1 container "" ""}}}
AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans',
[["Increment Enterprise Java Bean", 'Increment',
'Increment.jar,META-INF/ejb-jar.xml', 'jndi1', 'container', '', '']]])
AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans', [['.*', '.*',
'Increment', 'Increment.jar,.*', 'jndi1', 'container', '', '']]])
DataSourceFor10EJBModules
L'option DataSourceFor10EJBModules indique la source de données par défaut pour le module de bean enterprise qui contient les beans CMP 1.x. Utilisez cette option pour indiquer des données manquantes ou mettre à jour une tâche.
Chaque élément de l'option DataSourceFor10EJBModules comprend les zones suivantes : EJBModule, uri, JNDI, userName, password, login.config.name et auth.props. Parmi ces zones, les zones JNDI, userName, password, login.config.name et auth.props peuvent être associées à des valeurs.
- Module : Increment CMP 1.1 enterprise bean
- uri : IncCMP11.jar,META-INF/ejb-jar.xml
- Nom JNDI de la ressource cible : [DefaultDatasource]:
- Nom d'utilisateur : [null]:
- Mot de passe : [null]:
- Nom de configuration de connexion : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
- Propriétés : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
Si login.config.name prend la valeur DefaultPrincipalMapping, une propriété est créée avec le nom com.ibm.mapping.authDataAlias. La valeur de la propriété est définie par auth.props. Si le nom login.config ne prend pas la valeur DefaultPrincipalMapping, auth.props peut spécifier plusieurs propriétés. Le format de chaîne est websphere:name= <name1>,value=<value1>,description=<desc1>. Spécifiez plusieurs propriétés à l'aide du signe "+".
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install myapp.ear {-DataSourceFor10EJBModules {{"Increment CMP 1.1 EJB"
IncCMP11.jar,META-INF/ejb-jar.xml yourJNDI user2 password2 loginName authProps}}}
$AdminApp install myapp.ear {-DataSourceFor10EJBModules
{{.* IncCMP11.jar,.* yourJNDI user2 password2 loginName authProps}}}
AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules', [["Increment CMP 1.1 EJB",
'IncCMP11.jar,META-INF/ejb-jar.xml', 'yourJNDI', 'user2', 'password2',
'loginName', 'authProps']]])
AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules',
[['.*', 'IncCMP11.jar,.*', 'yourJNDI', 'user2', 'password2', 'loginName', 'authProps']]])
DataSourceFor20EJBModules
L'option DataSourceFor20EJBModules indique la source de données par défaut pour le module de bean enterprise 2.x qui contient des bean CMP (container managed persistence) 2.x. Utilisez cette option pour indiquer des données manquantes ou mettre à jour une tâche.
Chaque élément de l'option DataSourceFor20EJBModules comprend les zones suivantes : EJBModule, uri, JNDI, resAuth, login.config.name et auth.props. Parmi ces zones, les zones JNDI, resAuth, login.config.name et auth.props et les propriétés étendues des sources de données peuvent se voir attribuer des valeurs.
- Module : Increment enterprise bean
- URI: Increment.jar,META-INF/ejb-jar.xml
- Nom JNDI de la ressource cible : [DefaultDatasource]:
- Autorisation ressources : [par application]:
- Nom de configuration de connexion : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
- Propriétés : [] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
- Propriétés étendues de sources de données : []: utilisez cette option pour qu'une source de données utilisant un pool de connexions hétérogène puisse se connecter à une base de données DB2. Le masque de la propriété est propriété1=valeur1+propriété2=valeur2.
La dernière zone des entrées de cette tâche indique la valeur des droits d'accès aux ressources. Les valeurs admises pour les droits d'accès aux ressources sont Par fabrique de connexions ou Conteneur.
Si login.config.name prend la valeur DefaultPrincipalMapping, une propriété est créée avec le nom com.ibm.mapping.authDataAlias. La valeur de la propriété est définie par auth.props. Si le nom login.config ne prend pas la valeur DefaultPrincipalMapping, auth.props peut spécifier plusieurs propriétés. Le format de chaîne est websphere:name= <name1>,value=<value1>,description=<desc1>. Spécifiez plusieurs propriétés à l'aide du signe "+".
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez indiquer des données pour les lignes ou les entrées pour lesquelles il manque des informations ou une mise à jour est nécessaire.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install Increment.jar {-DataSourceFor20EJBModules
{{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
jndi2 container "" "" ""}}}
$AdminApp install Increment.jar {-DataSourceFor20EJBModules {{.*
Increment.jar,.* jndi2 container "" "" ""}}}
set s \"value1,value2\"
Dans la substitution de commande, référencez la variable comme indiqué dans l'exemple suivant :"clientApplicationInformation=value1,value2" avec "clientapplication=$s"
AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
[["Increment Enterprise Java Bean", 'Increment.jar,META-INF/ejb-jar.xml',
'jndi2', 'container', '', '', '']]])
AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
[['.*', 'Increment.jar,.*', 'jndi2', 'container', '', '', '']]])
'property1="value1,value2"+property2="value3,value4"'
defaultbinding.cf.jndi
L'option defaultbinding.cf.jndi indique le nom JNDI (Java Naming and Directory Interface) de la fabrique de connexions par défaut.
defaultbinding.cf.resauth
L'option defaultbinding.cf.resauth indique le RESAUTH pour la fabrique de connexions.
defaultbinding.datasource.jndi
L'option defaultbinding.datasource.jndi spécifie le nom JNDI pour la source de données par défaut.
defaultbinding.datasource.password
L'option defaultbinding.datasource.password indique le mot de passe pour la source de données par défaut.
defaultbinding.datasource.username
L'option defaultbinding.datasource.username spécifie le nom d'utilisateur pour la source de données par défaut.
defaultbinding.ee.defaults

defaultbinding.ejbjndi.prefix
L'option defaultbinding.ejbjndi.prefix indique le préfixe du nom JNDI (Java Naming and Directory Interface) du bean enterprise.
Pour utiliser l'option
defaultbinding.ejbjndi.prefix sur la plateforme z/OS, vous devez également spécifier l'option usedefaultbindings. Si vous ne spécifiez pas l'utilisation de l'option usedefaultbindings, l'option par défaut est nousedefaultbindings.
defaultbinding.force
L'option defaultbinding.force indique que les liaisons par défaut remplacent les liaisons actuelles.
defaultbinding.strategy.file
L'option defaultbinding.strategy.file indique un fichier de stratégie de liaison par défaut personnalisé.
defaultbinding.virtual.host
L'option defaultbinding.virtual.host indique le nom par défaut d'un hôte virtuel.
depl.extension.reg (obsolète)

deployejb
L'option deployejb indique l'exécution de l'outil EJBDeploy au cours de l'installation. Cette option ne nécessite pas de valeur. L'outil de déploiement EJBDeploy s'exécute pendant l'installation des modules EJB 1.x ou 2.x. L'outil de déploiement d'EJB ne fonctionne pas lors de l'installation des modules EJB 3.x.
Cette option est ignorée lorsque le fichier EAR ou le module à installer ou à mettre à jour contient un descripteur de déploiement d'application Java Platform, Enterprise Edition (Java EE) 7, un descripteur de déploiement de module EJB 3.2 ou un descripteur de déploiement de module Web 3.1.
Si vous prédéployez le fichier EAR à l'aide de l'outil EJBDeploy, la valeur par défaut est nodeployejb. Sinon, la valeur par défaut est deployejb.
- Le fichier EAR a été assemblé à l'aide d'un outil d'assemblage, tel que Rational Application Developer ; l'outil EJBDeploy n'a pas été lancé pendant l'assemblage.
- Le fichier EAR n'a pas été assemblé à l'aide d'un outil d'assemblage, tel que Rational Application Developer.
- Le fichier EAR a été assemblé à l'aide de versions de l'outil Application Assembly (AAT) antérieures à la version 5.0.
Si un module EJB est regroupé dans un fichier d'archive Web (WAR), vous n'avez pas besoin d'utiliser cette option deployejb.
Pour cette option, effectuez l'installation uniquement sur une cible de déploiement Version 9.0.
deployejb.classpath
L'option deployejb.classpath spécifie un chemin de classes supplémentaire pour l'outil EJBDeploy.
deployejb.complianceLevel
L'option deployejb.complianceLevel spécifie le niveau de conformité JDK pour l'outil EJBDeploy.
1.4 (default) 5.0 6.0
Pour obtenir la liste des niveaux de JDK actuellement pris en charge, exécutez la commande ejbdeploy -? d'administration.
deployejb.dbschema
L'option deployejb.dbschema indique le schéma de base de données pour l'outil EJBDeploy.
deployejb.dbtype
L'option deployejb.dbtype indique le type de base de données pour l'outil EJBDeploy.
DB2UDB_V81 DB2UDB_V82 DB2UDB_V91 DB2UDB_V95 DB2UDBOS390_V8 DB2UDBOS390_NEWFN_V8 DB2UDBOS390_V9
DB2UDBISERIES_V53 DB2UDBISERIES_V54 DB2UDBISERIES_V61 DERBY_V10 DERBY_V101 INFORMIX_V100 INFORMIX_V111 INFORMIX_V115
MSSQLSERVER_2005 ORACLE_V10G ORACLE_V11G SYBASE_V15 SYBASE_V125
Les bases de données suivantes prennent en charge le langage SQL (Structured Query Language) pour Java (SQLJ) : DB2UDB_V82, DB2UDB_V81, DB2UDBOS390_V7 et DB2UDBOS390_V8.Pour obtenir la liste des types de fournisseurs de base de données pris en charge, exécutez la commande ejbdeploy -?. d'administration.
deployejb.dbaccesstype
L'option deployejb.dbaccesstype indique le type d'accès à la base de données pour l'outil EJBDeploy. Les valeurs valides sont SQLj et JDBC. La valeur par défaut est JDBC.
deployejb.rmic
L'option deployejb.rmic indique les options RMIC supplémentaires pour utiliser l'outil EJBDeploy.
deployejb.sqljclasspath
L'option deployejb.sqljclasspath indique l'emplacement des classes du traducteur SQLJ.
deployws
L'option deployws indique de déployer les services Web au cours de l'installation. Cette option ne nécessite pas de valeur.
La valeur par défaut est nodeployws.
deployws.classpath
L'option deployws.classpath indique le chemin de classe supplémentaire à utiliser lorsque vous déployez des services Web.
Pour spécifier plusieurs entrées, séparez-les avec le caractère habituellement utilisé dans la variable d'environnement CLASSPATH.
Utilisez le point-virgule
(;) pour séparer les entrées.
Utilisez le signe deux-points (:) pour
séparer les entrées.
deployws.jardirs
L'option deployws.jardirs indique les répertoires d'extensions supplémentaires à utiliser lorsque vous déployez des services Web.
distributeApp
L'option distributeApp indique que le composant de gestion d'applications distribue les binaires des applications. Cette option ne nécessite pas de valeur. Il s'agit du réglage par défaut.
EmbeddedRar
L'option EmbeddedRar lie des objets J2C (Java 2 Connector) à des noms JNDI. Vous devez lier chaque objet Java 2 Connector dans votre application ou module (par exemple, fabriques de connexions J2C, spécifications d'activation J2C ou objets administratifs J2C) à un nom JNDI. Chaque élément de l'option EmbeddedRar contient les zones suivantes : RARModule, uri, j2cid, j2c.name, j2c.jndiName. Vous pouvez affecter les valeurs suivantes aux zones : j2c.name, j2c.jndiName.
Connector module: <rar module name>
URI: <rar name>,META-INF/ra.xml
Object identifier: <identifier of the J2C object>
name: j2cid
JNDI name: eis/j2cid
J2C connection factory: connectionFactoryInterface
J2C admin object: adminObjectInterface
J2C activation specification: message listener type
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Si l'ID n'est pas unique dans le fichier ra.xml, -<numéro> est ajouté. Par exemple, javax.sql.DataSource-2.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install $embeddedEar {-EmbeddedRar {{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml
javax.sql.DataSource javax.sql.DataSource1 eis/javax.sql.javax.sql.DataSSource1} {"FVT Resource Adapter"
jca15cmd.rar,META-INF/ra.xml javax.sql.DataSource2 javax.sql.DataSource2 eis/javax.sql.DataSource2} {"FVT Resource Adapter"
jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener javax.jms.MessageListener1 eis/javax.jms.MessageListener1} {"FVT Resource
Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageLListener2 javax.jms.MessageListener2 eis/javax.jms.MessageListener2}
{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml fvt.adapter.message.FVTMessageProvider
fvt.adapter.message.FVTMessageProvider1 eis/fvt.adapter.message.FVTMessageProvider1} {"FVT Resource Adapter"
jca15cmd.rar,META-INF/ra.xml fvt.adapter.message.FVTMessageProvider2 fvt.adapter.message.FVTMessageProvider2
eis/fvt.adapter.message.FVTMessageProvider2}}}
$AdminApp install $embeddedEar {-EmbeddedRar {{.* .* .* javax.sql.DataSource1
eis/javax.sql.javax.sql.DataSSource1} {.* .* .* javax.sql.DataSource2 eis/javax.sql.DataSource2} {.* .* .*
javax.jms.MessageListener1 eis/javax.jms.MessageListener1} {.* .* .* javax.jms.MessageListener2
eis/javax.jms.MessageListener2} {.* .* .* fvt.adapter.message.FVTMessageProvider1
eis/fvt.adapter.message.FVTMessageProvider1} {.* .* .* fvt.adapter.message.FVTMessageProvider2
eis/fvt.adapter.message.FVTMessageProvider2}}}
AdminApp.install(embeddedEar, ['-EmbeddedRar', [["FVT Resource Adapter",
'jca15cmd.rar,META-INF/ra.xml', 'javax.sql.DataSource', 'javax.sql.DataSource1', 'eis/javax.sql.javax.sql.DataSSource1'], ["FVT
Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml javax.sql.DataSource2', 'javax.sql.DataSource2', 'eis/javax.sql.DataSource2'],
["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener', 'javax.jms.MessageListener1',
'eis/javax.jms.MessageListener1'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageLListener2',
'javax.jms.MessageListener2', 'eis/javax.jms.MessageListener2'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml
fvt.adapter.message.FVTMessageProvider', 'fvt.adapter.message.FVTMessageProvider1',
'eis/fvt.adapter.message.FVTMessageProvider1'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml',
'fvt.adapter.message.FVTMessageProvider2', 'fvt.adapter.message.FVTMessageProvider2',
'eis/fvt.adapter.message.FVTMessageProvider2']]])
AdminApp.install(embeddedEar, ['-EmbeddedRar', [['.*', '.*', '.*', 'javax.sql.DataSource1',
'eis/javax.sql.javax.sql.DataSSource1'], ['.*', '.*', '.*', 'javax.sql.DataSource2', 'eis/javax.sql.DataSource2'], ['.*', '.*',
'.*', 'javax.jms.MessageListener1', 'eis/javax.jms.MessageListener1'], ['.*', '.*', '.*', 'javax.jms.MessageListener2',
'eis/javax.jms.MessageListener2'], ['.*', '.*', '.*', 'fvt.adapter.message.FVTMessageProvider1',
'eis/fvt.adapter.message.FVTMessageProvider1'], ['.*', '.*', '.*', 'fvt.adapter.message.FVTMessageProvider2',
'eis/fvt.adapter.message.FVTMessageProvider2']]])
enableClientModule
L'option enableClientModule indique qu'il faut déployer les modules client. Sélectionnez cette option si le fichier à déployer contient un ou plusieurs modules client et que vous souhaitez déployer. Si vous sélectionnez cette option, vous installez les modules client uniquement sur une cible de déploiement version 8.0 ou version ultérieure.
Cette option ne nécessite pas de valeur. La valeur par défaut est noenableClientModule. Par défaut, l'option enableClientModule est ignorée pendant le déploiement et les modules client ne sont pas déployés.
EnsureMethodProtectionFor10EJB
L'option EnsureMethodProtectionFor10EJB sélectionne des protections pour les méthodes non protégées de beans enterprise 1.x. Indiquez que la méthode doit rester non protégée, ou affectez une protection refusant tout accès. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install Increment.jar {-EnsureMethodProtectionFor10EJB
{{"Increment EJB Module" IncrementEJBBean.jar,META-INF/ejb-jar.xml ""}
{"Timeout EJB Module" TimeoutEJBBean.jar,META-INF/ejb-jar.xml
methodProtection.denyAllPermission}}}
$AdminApp install myapp.ear {-EnsureMethodProtectionFor10EJB
{{.* IncrementEJBBean.jar,.* ""} {.* TimeoutEJBBean.jar,.*
methodProtection.denyAllPermission}}}
AdminApp.install('Increment.jar', '[-EnsureMethodProtectionFor10EJB
[["Increment EJB Module" IncrementEJBBean.jar,META-INF/ejb-jar.xml ""]
["Timeout EJB Module" TimeoutEJBBean.jar,META-INF/ejb-jar.xml
methodProtection.denyAllPermission]]]')
AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor10EJB',
[['.*', 'IncrementEJBBean.jar,.*', ""], ['.*', 'TimeoutEJBBean.jar,.*',
'methodProtection.denyAllPermission']]])
La dernière zone des entrées de cette tâche indique la valeur de la protection. Les valeurs de protection admises sont : methodProtection.denyAllPermission. Vous pouvez aussi laisser la zone vide pour que la méthode ne soit pas protégée.
EnsureMethodProtectionFor20EJB
L'option EnsureMethodProtectionFor20EJB sélectionne des protections pour les méthodes non protégées de beans enterprise 2.x. Indiquez d'affecter un rôle de sécurité à la méthode non protégée, ajoutez la méthode à la liste d'exclusion ou marquez la méthode comme effacée. Vous pouvez affecter plusieurs rôles à une méthode en séparant les noms des rôles à l'aide de virgules. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez indiquer des données pour les lignes ou les entrées pour lesquelles il manque des informations ou une mise à jour est nécessaire.
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
{{CustmerEjbJar customerEjb.jar,META-INF/ejb-jar.xml methodProtection.uncheck}
{SupplierEjbJar supplierEjb.jar,META-INF/ejb-jar.xml methodProtection.exclude}}}
En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
{{.* customerEjb.jar,.* methodProtection.uncheck}
{.* supplierEjb.jar,.* methodProtection.exclude}}}
AdminApp.install('myapp.ear', '[-EnsureMethodProtectionFor20EJB
[[CustmerEjbJar customerEjb.jar,META-INF/ejb-jar.xml methodProtection.uncheck]
[SupplierEjbJar supplierEjb.jar,META-INF/ejb-jar.xml methodProtection.exclude]]]')
AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor20EJB',
[['.*', 'customerEjb.jar,.*', 'methodProtection.uncheck'],
['.*', 'supplierEjb.jar,.*', 'methodProtection.exclude']]])
La dernière zone des entrées de cette tâche indique la valeur de la protection. Les valeurs de protection possibles sont : methodProtection.uncheck, methodProtection.exclude, ou une liste de rôles de sécurité séparés par des virgules.
filepermission
.*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755
Exemple d'utilisation en mode de traitement par lots
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
{-appname MyApp -cell myCell -node myNode -server server1
-filepermission .*\\.jsp=777#.*\\.xml=755}
AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
["-appname", "MyApp", "-cell", "myCell", "-node", "myNode", "-server", "server1",
"-filepermission", ".*\\.jsp=777#.*\\.xml=755"])
installdir (déconseillé)

installed.ear.destination
L'option installed.ear.destination indique le répertoire dans lequel les fichiers binaires de l'application doivent être placés.
JSPCompileOptions
- Module Web : xxx
- URI : xxx
- Chemin de classes JSP : <jsp class path>
- Utiliser des noms de module complets : Oui | Non
- Niveau de source de kit JDK : xx
- Désactiver la compilation d'exécution JSP : Oui | Non
Pour Utiliser des noms de module complets et Désactiver la compilation d'exécution JSP, spécifiez la valeur Oui ou Non dans la langue de l'environnement local. Le produit prend en charge les valeurs AppDeploymentOption.Yes et AppDeploymentOption.No à la place de Oui et Non. Toutefois, il est recommandé de spécifier Oui ou Non dans la langue de votre environnement local.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install app_server_root/installableApps/ivtApp.ear
{-appname MyApp -preCompileJSPs -JSPCompileOptions {{"IVT Application"
ivt_app.war,WEB-INF/web.xml jspcp Yes 15 No}}}
$AdminApp install ivtApp.ear {-appname MyApp -preCompileJSPs -JSPCompileOptions
{{.* .* jspcp Yes 15 No}}}
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
['-appname', 'MyApp', '-preCompileJSPs', '-JSPCompileOptions',
[["IVT Application", 'ivt_app.war,WEB-INF/web.xml', 'jspcp',
'Yes', 15, 'No']]])
AdminApp.install('ivtApp.ear', ['-appname', 'MyApp', '-preCompileJSPs',
'-JSPCompileOptions', [['.*', '.*', 'jspcp', 'Yes', 15, 'No']]])
JSPReloadForWebMod
- Module Web : xxx
- URI : xxx
- Activation du rechargement de classe JSP : <Oui | Non>
- Intervalle de rechargement JSP en secondes : <jsp reload internal number>
Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp.
Pour l'option Activer le rechargement des classes JSP, entrez la valeur Oui ou Non dans la langue définie dans les paramètres régionaux. Le produit prend en charge les valeurs AppDeploymentOption.Yes et AppDeploymentOption.No à la place de Oui et Non. Toutefois, il est recommandé de spécifier Oui ou Non dans la langue de votre environnement local.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install app_server_root/installableApps/ivtApp.ear
{-appname MyApp -JSPReloadForWebMod {{"IVT Application"
ivt_app.war,WEB-INF/web.xml Yes 5}}}
$AdminApp install app_server_root/installableApps/ivtApp.ear
{-appname MyApp -JSPReloadForWebMod {{.* .* Yes 5}}}
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
['-appname', 'MyApp', '-JSPReloadForWebMod [["IVT Application"
ivt_app.war,WEB-INF/web.xml Yes 5 ]]'])
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
['-appname', 'MyApp', '-JSPReloadForWebMod', [['.*', '.*', 'Yes', ‘5']]])

Toutefois, un module Java EE 5 ou version ultérieure peut exister dans une application qui inclut des fichiers antérieurs à Java EE 5 et utilise l'extension de nom de fichier .xmi.
Les fichiers ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi et ibm-portlet-ext.xmi continuent d'utiliser les extensions de fichier .xmi.
sptcfgMapEJBRefToEJB
L'option MapEJBRefToEJB mappe des références Java enterprise vers des beans enterprise. Vous devez mapper chaque référence de bean enterprise définie dans votre application vers un bean enterprise. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.
Si la référence d'EJB provient d'un module EJB 3.x, Web 2.4 ou Web 2.5, le nom JNDI est facultatif. Si vous spécifiez l'option useAutoLink, le nom JNDI est facultatif. S'il n'est pas indiqué, l'environnement d'exécution fournit une valeur par défaut propre au conteneur. Un module EJB 3.0 ou version ultérieure ne peut pas contenir de beans d'entité CMP ou BMP. L'installation d'une application Java EE échoue si celle-ci contient un module EJB 3.x avec un ou plusieurs beans d'entité CMP ou BMP. Les beans d'entité CMP ou BMP doivent être empaquetés dans un module EJB 2.1 ou version antérieure.
Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp. Il suffit d'indiquer des données pour les lignes ou les entrées où il manque des informations ou celles dans lesquelles les données doivent être mises à jour.
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
$AdminApp install techapp.ear {-MapEJBRefToEJB {{"JAASLogin" "" JAASLoginWeb.war,
WEB-INF/web.xml WSsamples/JAASLogin jaasloginejb.SampleBean TechApp/JAASLogin}}
-MapWebModToVH {{"Web Application" Tech.war,WEB-INF/web.xml default_host}}}
En langage Jacl avec appariement de formes :
![[Windows]](../images/windows.gif)
$AdminApp install C:/myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$AdminApp install myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}
AdminApp.install('techapp.ear','[
-MapEJBRefToEJB [["JAASLogin" "" JAASLoginWeb.war,WEB-INF/web.xml WSsamples/JAASLogin]]
-MapWebModToVH [["Web Application" tech.war,WEB-INF/web.xml default_host]]]')
Avec Jython avec appariement de formes :
![[Windows]](../images/windows.gif)
AdminApp.install('C:/myapp.ear', ['-MapEJBRefToEJB',
[['.*', '.*', '.*', '.*', '.*', 'MyBean']]])
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.install('myapp.ear', ['-MapEJBRefToEJB',
[['.*', '.*', '.*', '.*', '.*', 'MyBean']]])
MapEnvEntryForApp
L'option MapEnvEntryForApp édite la valeur env-entry de l'application. Vous pouvez utiliser cette option pour éditer la valeur de env-entry dans le fichier application.xml.
- Nom : xxx
- Type : xxx
- Description : xxx
Eviter les incidents: Si, après l'exécution des liaisons par défaut, la valeur est null, vous devez la remplacer par .* avant d'exécuter la tâche. La valeur .* est la valeur générique qui correspond à n'importe quelle description. Si vous conservez la valeur null, des exceptions sont émises lorsque vous exécutez la tâche MapEnvEntryForApp.gotcha
- Valeur : <valeur env-entry>
Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install app_server_root/installableApps/ivtApp.ear
{-appname MyApp -MapEnvEntryForApp {{MyApp/appEnvEntry String null newEnvEntry}}}
$AdminApp install app_server_root/installableApps/ivtApp.ear
{-appname MyApp2 -MapEnvEntryForApp {{.* .* .* newEnvEntry}}}
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
['-appname', 'MyApp3', '-MapEnvEntryForApp', [['MyApp/appEnvEntry', 'String', 'null', 'newEnvEntry']]])
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
['-appname', 'MyApp4', '-MapEnvEntryForApp', [['.*', '.*', '.*', 'newEnvEntry']]])
Si la description comporte un caractère de passage à la ligne, utilisez la syntaxe suivante :
$AdminApp install app_server_root/installableApps/ivtApp.ear
{-appname MyApp5 -MapEnvEntryForApp {{.* .* (?s).* newEnvEntry}}}
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
['-appname', 'MyApp6', '-MapEnvEntryForApp',
[['.*', '.*', '(?s).*', 'newEnvEntry']]])
MapEnvEntryForClientMod
L'option MapEnvEntryForClientMod édite la valeur env-entry du module. Vous pouvez utiliser cette option pour modifier la valeur des entrées d'environnement dans le fichier application-client.xml du module client.
- Module client : xxx
- URI : xxx
- Nom : xxx
- Type : xxx
- Description : xxx
- Valeur : <valeur env-entry>
Pour obtenir des informations sur les données nécessaires à votre module client, utilisez la commande taskInfo de l'objet AdminApp.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install app_server_root/installableApps/myapp.ear
{-appname MyApp -MapEnvEntryForClientMod {{"Client Module" client.jar,META-INF/application-client.xml
clientObject String null newValue}}}
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.* .* .*
.* .* newValue}}}
AdminApp.install('app_server_root/installableApps/myapp.ear',
['-appname', 'MyApp', '-MapEnvEntryForClientMod', [["Client Module",
'client.jar,META-INF/application-client.xml', 'clientObject',
'String', 'null', 'newValue']]])
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
[['.*', '.*', '.*', '.*', '.*', 'newValue']]])
Si la description comporte un caractère de passage à la ligne, utilisez la syntaxe suivante :
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.* .* .*
(?s).* newValue}}}
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
[['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])
MapEnvEntryForEJBMod
L'option MapEnvEntryForEJBMod édite la valeur env-entry du module EJB. Vous pouvez utiliser cette option pour modifier la valeur des entrées d'environnement dans le fichier EJB.xml du module EJB.
- Module : xxx
- URI : xxx
- Bean : xxx
- Nom : xxx
- Type : xxx
- Description : xxx
Eviter les incidents: Si, après l'exécution des liaisons par défaut, la valeur est null, vous devez la remplacer par .* avant d'exécuter la tâche. La valeur .* est la valeur générique qui correspond à n'importe quelle description. Si la valeur null est conservée, les exceptions WASX7017E et WASX7111E se produisent lors de l'exécution de la tâche MapEnvEntryForEJBMod. gotcha
- Valeur : <valeur env-entry>
Si le module EJB utilise la spécification EJB version 3.0 ou supérieure, cette option ne contient que les éléments fournis par le descripteur de déploiement XML. Cette option ne permet pas de récupérer des informations de déploiement provenant d'annotations.
Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install app_server_root/installableApps/ivtApp.ear
{-appname MyApp -MapEnvEntryForEJBMod {{"IVT EJB Module" ivtEJB.jar,META-INF/ejb-jar.xml
ivtEJBObject ejb/ivtEJBObject String null newValue}}}
$AdminApp install myapp.jar {-appname MyApp -MapEnvEntryForEJBMod {{.* .* .*
.* .* .* newValue}}}
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
['-appname', 'MyApp', '-MapEnvEntryForEJBMod', [["IVT EJB Module",
'ivtEJB.jar,META-INF/ejb-jar.xml', 'ivtEJBObject', 'ejb/ivtEJBObject',
'String', 'null', 'newValue']]])
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
[['.*', '.*', '.*', '.*', '.*', '.*', 'newValue']]])
Si la description comporte un caractère de passage à la ligne, utilisez la syntaxe suivante :
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForEJBMod {{.* .* .*
(?s).* newValue}}}
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
[['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])
MapEnvEntryForWebMod
L'option MapEnvEntryForWebMod édite la valeur env-entry du module Web. Vous pouvez utiliser cette option pour modifier la valeur de env-entry dans le fichier web.xml.
- Module Web : xxx
- URI : xxx
- Nom : xxx
- Type : xxx
- Description : xxx
Eviter les incidents: Si, après l'exécution des liaisons par défaut, la valeur est null, vous devez la remplacer par .* avant d'exécuter la tâche. La valeur .* est la valeur générique qui correspond à n'importe quelle description. Si la valeur null est conservée, les exceptions WASX7017E et WASX7111E se produisent lors de l'exécution de la tâche MapEnvEntryForWebMod. gotcha
- Valeur : <valeur env-entry>
Si le module Web utilise un servlet 2.5, cette option ne contient que des données provenant du descripteur de déploiement XML. Cette option ne permet pas de récupérer des informations de déploiement provenant d'annotations.
Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install app_server_root/installableApps/ivtApp.ear
{-appname MyApp -MapEnvEntryForWebMod {{"IVT Application" ivt_app.war,
WEB-INF/web.xml ivt/ivtEJBObject String null newEnvEntry}}}
$AdminApp install app_server_root/installableApps/ivtApp.ear
{-appname MyApp2 -MapEnvEntryForWebMod {{.* .* .* .* newEnvEntry}}}
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
['-appname', 'MyApp3', '-MapEnvEntryForWebMod', [["IVT Application",
'ivt_app.war,WEB-INF/web.xml', 'ivt/ivtEJBObject', 'String', 'null', 'newEnvEntry']]])
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
['-appname', 'MyApp4', '-MapEnvEntryForWebMod', [['.*', '.*', '.*', '.*', 'newEnvEntry']]])
Si la description comporte un caractère de passage à la ligne, utilisez la syntaxe suivante :
$AdminApp install app_server_root/installableApps/ivtApp.ear
{-appname MyApp5 -MapEnvEntryForWebMod {{.* .* .* (?s).* newEnvEntry}}}
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
['-appname', 'MyApp6', '-MapEnvEntryForWebMod',
[['.*', '.*', '.*', '(?s).*', 'newEnvEntry']]])
MapInitParamForServlet
- Module Web : xxx
- URI : xxx
- Servlet : xxx
- Nom : xxx
- Description: null
- Valeur : <valeur de paramètre initiale>
Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install app_server_root/installableApps/ivtApp.ear
{-appname MyApp -MapInitParamForServlet {{"IVT Application"
ivt_app.war,WEB-INF/web.xml ivtservlet pName1 null MyInitParamValue}}}
$AdminApp install myapp.ear {-appname MyApp -MapInitParamForServlet
{{.* .* .* .* .* MyInitParamValue}}}
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
['-appname', 'MyApp', '-MapInitParamForServlet', [["IVT Application",
'ivt_app.war,WEB-INF/web.xml', 'ivtservlet', 'pName1', 'null', 'MyInitParamValue']]])
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapInitParamForServlet',
[['.*', '.*', '.*', '.*', '.*', 'MyInitParamValue']]])
MapJaspiProvider
- Module : xxx
- URI : xxx
- Utiliser JASPI : Oui | Non | Hériter
- Nom du fournisseur JASPI : xxx
Pour Utiliser JASPI, spécifiez la valeur Oui, Non ou Hériter dans la langue de votre environnement local.
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez indiquer des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install myapp.ear {-MapJaspiProvider {{myapp META-INF/application.xml Yes Provider1} }}
AdminApp.install('myapp.ear', '[-appname myapp
-MapJaspiProvider [[myapp META-INF/application.xml Yes Provider1] ]]')
MapMessageDestinationRefToEJB
L'option MapMessageDestinationRefToEJB mappe les références de destination de message vers des noms JNDI (Java Naming and Directory Interface) des objets d'administration à partir des adaptateurs de ressources installés. Vous devez mapper chaque référence de destination de message définie dans l'application vers un objet d'administration. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.
- Module : ejb-jar-ic.jar
- Bean : MessageBean
- URI : ejb-jar-ic.jar,META-INF/ejb-jar.xml
- Objet de destination du message : jms/GSShippingQueue
- Nom JNDI de la ressource cible : [jms/GSShippingQueue]:
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install BankFull.ear {-MapMessageDestinationRefToEJB {{BankCMRQLEJB
Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue} }}
$AdminApp install $earfile {-MapMessageDestinationRefToEJB {{.* .* .* MyConnection
jndi2} {.* .* .* PhysicalTopic jndi3} {.* .* .* jms/ABC jndi4}}}
AdminApp.install('BankFull.ear', '[ -MapMessageDestinationRefToEJB [[ BankCMRQLEJB
Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue ]]]' )
AdminApp.install(ear1, ['-MapMessageDestinationRefToEJB', [['.*', '.*', '.*', 'MyConnection',
'jndi2'], ['.*', '.*', '.*', 'PhysicalTopic', 'jndi3'], ['.*', '.*', '.*', 'jms/ABC', 'jndi4']]])
MapModulesToServers
L'option MapModulesToServers indique le serveur d'applications sur lequel vous souhaitez installer les modules contenus dans votre application. Vous pouvez installer des modules sur le même serveur ou les répartir sur plusieurs serveurs. Utilisez cette option pour indiquer les données manquantes ou mettre à jour une tâche.
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
L'exemple suivant installe Increment.jar sur un seul serveur :
$AdminApp install Increment.jar {-MapModulesToServers
{{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
WebSphere:cell=mycell,node=mynode,server=server1}}}
AdminApp.install('Increment.jar', '[-MapModulesToServers
[["Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
WebSphere:cell=mycell,node=mynode,server=server1] ]]')
L'exemple suivant installe Increment.jar et l'associe à deux serveurs gérés par un gestionnaire de déploiement :
$AdminApp install Increment.jar {-MapModulesToServers
{{ "Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
WebSphere:cell=mycell,node=mynode,server=server1+WebSphere:cell=mycell,node=mynode,server=server2}}}
AdminApp.install('Increment.jar', '[ -MapModulesToServers
[[ "Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
WebSphere:cell=mycell,node=mynode,server=server1+WebSphere:cell=mycell,node=mynode,server=server2]]]')
L'exemple suivant ajoute server2 et server3 pour une application qui est déjà installée :
$AdminApp install myapp.ear {-MapModulesToServers {{.* .*
+WebSphere:cell=mycell,node=mynode,server=server2+WebSphere:cell=mycell,node=mynode,server=server3}}
-appname myapp -update -update.ignore.old}
AdminApp.install('myapp.ear', ['-MapModulesToServers', [['.*', '.*',
'+WebSphere:cell=mycell,node=mynode,server=server2+WebSphere:cell=mycell,node=mynode,server=server3']],
'-appname', 'myapp', '-update', '-update.ignore.old'])
L'exemple suivant supprime server1 de l'application installée :
$AdminApp edit myapp {-MapModulesToServers
{{.* .* -WebSphere:cell=mycell,node=mynode,server=server1}}
-update -update.ignore.old}
AdminApp.edit('myapp', ['-MapModulesToServers',
[['.*', '.*', '-WebSphere:cell=mycell,node=mynode,server=server1']]])
MapResEnvRefToRes
L'option MapResEnvRefToRes mappe les références d'environnement de ressources vers des ressources. Vous devez mapper chaque référence d'environnement de ressource définie dans l'application vers une ressource. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install app_server_root/installableApps/sibwsjmsepl.ear {
-BindJndiForEJBMessageBinding {{ SOAPJMSEndpoint SOAPJMSEndpoint
SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml lp1 "" "" "" }}
-MapResEnvRefToRes {{SOAPJMSEndpoint SOAPJMSEndpoint
SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml jms/WebServicesReplyQCF
javax.jms.QueueConnectionFactory jndi1}}}
$AdminApp install app_server_root/installableApps/sibwsjmsepl.ear {
-MapResEnvRefToRes {{.* .* .* .* .* jndi1}}}
AdminApp.install('app_server_root/installableApps/sibwsjmsepl.ear', '[
-BindJndiForEJBMessageBinding [[ SOAPJMSEndpoint SOAPJMSEndpoint
SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml lp1 "" "" "" ]]
-MapResEnvRefToRes [[ SOAPJMSEndpoint SOAPJMSEndpoint
SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml jms/WebServicesReplyQCF
javax.jms.QueueConnectionFactory jndi1 ]]]' )
AdminApp.install('app_server_root/installableApps/sibwsjmsepl.ear',
['-MapResEnvRefToRes', [['.*', '.*', '.*', '.*', '.*', 'jndi1']]])
MapResRefToEJB
L'option MapResRefToEJB mappe les références de ressource vers des ressources. Vous devez mapper chaque référence de ressource définie dans l'application vers une ressource. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.
- Module : Ejb1
- Bean : MailEJBObject
- URI: deplmtest.jar,META-INF/ejb-jar.xml
- Référence de ressource : jms/MyConnectionFactory
- Type de ressource : javax.jms.ConnectionFactory
- Nom JNDI de la ressource cible : [jms/MyConnectionFactory] :
- Nom de configuration de connexion : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
- Propriétés : [] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
- Propriétés étendues de sources de données : []: utilisez cette option pour qu'une source de données utilisant un pool de connexions hétérogène puisse se connecter à une base de données DB2. Le masque de la propriété est propriété1=valeur1+propriété2=valeur2
La configuration de connexion DefaultPrincipalMapping est utilisée par les connecteurs J2C (Java 2 Connectors) pour associer les utilisateurs aux principaux définis dans les entrées de données d'authentification J2C. Si login.config.name prend la valeur DefaultPrincipalMapping, une propriété est créée avec le nom com.ibm.mapping.authDataAlias. La valeur de la propriété est définie par auth.props. Si le nom login.config ne prend pas la valeur DefaultPrincipalMapping, auth.props peut spécifier plusieurs propriétés. Le format de la chaîne est websphere:name= <nom1>,value=<valeur1>,description=<desc1>. Pour spécifier plusieurs propriétés, utilisez le signe Plus (+).
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install myapp.ear {-MapResRefToEJB
{{deplmtest.jar MailEJBObject deplmtest.jar,META-INF/ejb-jar.xml mail/MailSession9
javax.mail.Session jndi1 login1 authProps1 "clientApplicationInformation=new application"}
{"JavaMail Sample WebApp" "" mtcomps.war,WEB-INF/web.xml mail/MailSession9
javax.mail.Session jndi2 login2 authProps2 ""}}}
$AdminApp install myapp.ear {-MapResRefToEJB
{{deplmtest.jar .* .* .* .* jndi1 login1 authProps1
"clientApplicationInformation=new application"}
{"JavaMail Sample WebApp" .* .* .* .* jndi2 login2 authProps2 ""}}}
set s \"value1,value2\"
Dans la substitution de commande, référencez la variable comme indiqué dans l'exemple suivant :"clientApplicationInformation=value1,value2" avec "clientapplication=$s"
AdminApp.install('myapp.ear', ['-MapResRefToEJB',
[['deplmtest.jar', 'MailEJBObject', 'deplmtest.jar,META-INF/ejb-jar.xml
mail/MailSession9', 'javax.mail.Session', 'jndi1', 'login1', 'authProps1',
'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
["JavaMail Sample WebApp", "", 'mtcomps.war,WEB-INF/web.xml', 'mail/MailSession9',
'javax.mail.Session', 'jndi2', 'login2', 'authProps2', '']]])
AdminApp.install('myapp.ear', ['-MapResRefToEJB',
[['deplmtest.jar', '.*', '.*', '.*', '.*', 'jndi1', 'login1', 'authProps1',
'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
["JavaMail Sample WebApp", '', '.*', '.*', '.*', 'jndi2', 'login2',
'authProps2', '']]])
'property1="value1,value2"+property2="value3,value4"'
MapRolesToUsers
L'option MapRolesToUsers mappe les utilisateurs vers des rôles. Vous devez mapper chaque rôle défini dans l'application ou le module vers un utilisateur ou un groupe à partir du registre d'utilisateurs du domaine. Vous pouvez spécifier plusieurs utilisateurs ou groupes pour un rôle unique en les séparant par le signe "|". Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install myapp.ear {-MapRolesToUsers {{"All Role" No Yes "" ""}
{"Every Role" Yes No "" ""} {DenyAllRole No No user1 group1}}}
AdminApp.install('myapp.ear', '[-MapRolesToUsers [["All Role" No Yes "" ""]
["Every Role" Yes No "" ""] [DenyAllRole No No user1 group1]]]')
où {{"Tous les rôles" No Yes "" ""} ont la signification suivante :
Option | Description |
---|---|
"Tous les rôles" | Représente le nom du rôle. |
Non | Indique d'autoriser l'accès à tous les utilisateurs (oui/non) |
Oui | Indique d'autoriser l'accès à tous les utilisateurs non authentifiés (oui/non). |
"" | Indique les utilisateurs mappés. |
"" | Indique les groupes mappés. |
"AllAuthenticatedInTrustedRealms" | Indique que tous les utilisateurs valides définis dans le domaine sécurisé disposent du droit d'accès. |
"ID des accès utilisateurs mappés" | Identifiants des accès utilisateur mappés |
"ID des accès groupes mappés" | Identifiants des accès groupes mappés |
MapRunAsRolesToUsers
L'option MapRunAsRolesToUsers mappe les rôles RunAs vers des utilisateurs. Les beans d'entreprise que vous installez contiennent des rôles d'exécution prédéfinis. Les rôles RunAs sont utilisés par les beans enterprise qui doivent s'exécuter en tant que rôle particulier pour être reconnus pendant l'interaction avec un autre bean enterprise. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
![[Windows]](../images/windows.gif)
$AdminApp install C:/myapp.ear {-MapRunAsRolesToUsers {{UserRole user1
password1} {AdminRole administrator administrator}}}
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$AdminApp install myapp.ear {-MapRunAsRolesToUsers {{UserRole user1
password1} {AdminRole administrator administrator}}}
En langage Jython :
![[Windows]](../images/windows.gif)
AdminApp.install('C:/myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1
password1] [AdminRole administrator administrator]]]')
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.install('myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1
password1][AdminRole administrator administrator]]]')
MapSharedLibForMod
- Module : xxx
- URI : META-INF/application.xml
- Bibliothèques partagées : <share libraries>
Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
{-appname DynaCacheEsi -MapSharedLibForMod {{ DynaCacheEsi META-INF/application.xml
sharedlib1 }{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 }}}
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
{-appname DynaCacheEsi -MapSharedLibForMod {{ .* .* sharedlib1 }
{ .* .* sharedlib2 }}}
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
'[ -MapSharedLibForMod [[ DynaCacheEsi META-INF/application.xml sharedlib1 ]
[ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 ]]]' )
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
'[ -MapSharedLibForMod [[ .* .* sharedlib1 ][ .* .* sharedlib2 ]]]' )
MapWebModToVH
L'option MapWebModToVH sélectionne des hôtes virtuels pour les modules Web. Spécifiez l'hôte virtuel sur lequel vous souhaitez installer les modules Web contenus dans l'application. Vous pouvez installer des modules Web sur le même hôte virtuel ou les répartir sur plusieurs hôtes. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
{-appname DynaCacheEsi
-MapWebModToVH {{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host }}}
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
{-MapWebModToVH {{ .* .* default_host }}}
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
'[-MapWebModToVH [[ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host ]]]')
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
['-MapWebModToVH', [['.*', '.*', 'default_host']]])
MetadataCompleteForModules
L'option MetadataCompleteForModules permet à chaque module Java EE 5 ou de version ultérieure d'écrire le descripteur de déploiement complet, y compris les informations de déploiement des annotations. Le système marque alors le descripteur comme complet.

- Module : EJBDD_1.jar
- URI : EJBDD_1.jar,META-INF/ejb-jar.xml
- Verrouiller le descripteur de déploiement : [false]:
- Module : EJBNoDD_2.jar
- URI : EJBNoDD_2.jar,META-INF/ejb-jar.xml
- Verrouiller le descripteur de déploiement : [false]:
Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application.
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
![[Windows]](../images/windows.gif)
$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
{{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$AdminApp install myapp.ear {-MetadataCompleteForModules
{{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}
En langage Jacl avec appariement de formes :
![[Windows]](../images/windows.gif)
$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
{{.* EJBDD_1.jar,.* false}}}
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$AdminApp install myapp.ear
{-MetadataCompleteForModules {{.* EJBDD_1.jar,.* false}}}
En langage Jython :
![[Windows]](../images/windows.gif)
AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules',
[['EJBDD_1,jar', 'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.install('myapp.ear', ['-MetadataCompleteForModules',
[['EJBDD_1,jar', 'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])
Avec Jython avec appariement de formes :
![[Windows]](../images/windows.gif)
AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', [['.*',
'EJBDD_1.jar,.*', 'false']]]
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.install('myapp.ear',
['-MetadataCompleteForModules', [['.*', 'EJBDD_1.jar,.*', 'false']]]
ModuleBuildID
L'option ModuleBuildID affiche l'identificateur de compilation d'un module dans un fichier EAR d'application. Vous ne pouvez pas modifier cette option car elle est en lecture seule. Cette option renvoie les informations de version de compilation d'un module si son identificateur de compilation a été indiqué dans le fichier MANIFEST.MF du module ou du fichier EAR de l'application. Les informations de compilation sont constituées du nom du module, de son URI et de son identificateur de compilation.
- Module: CacheClient
- URI: CacheClient.jar,META-INF/application-client.xml
- Build ID: alpha
- Module: MailConnector
- URI: Mail.rar,META-INF/ra.xml
- Build ID: abc
- Module: CacheWeb1
- URI: CacheWeb1.war,WEB-INF/web.xml
- Build ID: alpha
- Module: JspWeb1
- URI: JspWeb1.war,WEB-INF/web.xml
- Build ID: v1.0
- Module: Servlet
- URI: Servlet.war,WEB-INF/web.xml
- Build ID: 0.5
Exemple d'utilisation en mode de traitement par lots
En langage Jython :
![[Windows]](../images/windows.gif)
print AdminApp.taskInfo('c:/temp/Cache2.ear', 'ModuleBuildID')
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
print AdminApp.taskInfo('/temp/Cache2.ear', 'ModuleBuildID')
noallowDispatchRemoteInclude
L'option noallowDispatchRemoteInclude désactive l'application d'entreprise qui distribue, via le répartiteur de demandes standard, des includes à des ressources situées dans des modules Web se trouvant sur des machines virtuelles Java différentes dans un environnement de noeuds gérés.
noallowPermInFilterPolicy
L'option noallowPermInFilterPolicy indique que le processus du déploiement d'application ne doit pas continuer si l'application contient des droits basés sur des règles, qui se trouvent dans les règles de filtrage. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur.
noallowServiceRemoteInclude
L'option noallowServiceRemoteInclude désactive l'application d'entreprise qui initie une demande d'inclusion à partir d'une application d'entreprise dont l'option allowDispatchRemoteInclude a pour valeur true.
noeud
L'option node indique le nom de noeud pour installer ou mettre à jour une application entière, ou pour mettre à jour une application afin d'ajouter un nouveau module. Si vous souhaitez mettre à jour une application entière, cette option ne s'applique que si l'application contient un nouveau module qui n'existe pas dans l'application d'installation.
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
![[Windows]](../images/windows.gif)
$AdminApp install "C:/myapp.ear" {-node nodeName}
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$AdminApp install "/myapp.ear" {-node nodeName}
En langage Jython :
![[Windows]](../images/windows.gif)
AdminApp.install('C:/myapp/myapp.ear', '[-node nodeName]')
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.install('/myapp/myapp.ear', '[-node nodeName]')
nocreateMBeansForResources
L'option nocreateMBeansForResources indique qu'il n'est pas créé de beans gérés pour toutes les ressources (servlets, fichiers JSP et beans enterprise) définies dans une application lorsque l'application démarre sur une cible de déploiement. Cette option est le réglage par défaut et elle ne nécessite pas de valeur.
nodeployejb
L'option nodeployejb indique de ne pas exécuter l'outil EJBDeploy au cours de l'installation. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur.
nodeployws
L'option nodeployws indique de ne pas déployer les services Web au cours de l'installation. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur.
nodistributeApp
L'option nodistributeApp indique que le composant de gestion d'application ne distribue pas les fichiers binaires de l'application. Cette option ne nécessite pas de valeur. Le réglage par défaut est l'option distributeApp.
noenableClientModule
L'option noenableClientModule indique qu'il ne faut pas déployer les modules client. Cette option ne nécessite pas de valeur. Il s'agit de la valeur par défaut. Par défaut, les modules client ne sont pas déployés. Utilisez l'option enableClientModule pour déployer les modules client.
noreloadEnabled
L'option noreloadEnabled désactive le rechargement des classes. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur. Utilisez l'option reloadEnabled pour demander que le système de fichiers de l'application soit balayé afin d'y détecter les fichiers modifiés et de les recharger dynamiquement.
nopreCompileJSPs
L'option nopreCompileJSPs indique que les fichiers JavaServer Pages ne doivent pas être précompilés. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur.
noprocessEmbeddedConfig
L'option noprocessEmbeddedConfig indique que le système doit ignorer les données de configuration incluses dans l'application. Cette option ne nécessite pas de valeur. Si le fichier EAR de l'application ne contient pas de données de configuration, l'option noprocessEmbeddedConfig constitue le réglage par défaut. Autrement, le réglage par défaut est l'option processEmbeddedConfig.
nouseAutoLink
L'option nouseAutoLink spécifie de ne pas utiliser l'option useAutoLink qui permet de résoudre automatiquement les références d'EJB (Enterprise JavaBeans) à partir des versions de modules EJB antérieures à la version 3.0, et de modules Web antérieures à la version 2.4.
nouseMetaDataFromBinary
L'option nouseMetaDataFromBinary indique que les métadonnées utilisées lors de l'exécution, par exemple, les descripteurs de déploiement, les liaisons, les extensions, etc. proviennent du référentiel de configuration. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur. Utilisez cette option pour indiquer que les métadonnées utilisées lors de l'exécution proviennent du fichier EAR (Enterprise Archive).
nousedefaultbindings
L'option nousedefaultbindings indique que les liaisons par défaut ne doivent pas être utilisées pour l'installation. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur.
novalidateSchema
L'option novalidateSchema indique qu'il ne faut pas valider les descripteurs de déploiement par rapport aux schémas de descripteur de déploiement Java EE. Cette option ne nécessite pas de valeur. Il s'agit de la valeur par défaut. Par défaut, il ne faut pas valider les descripteurs de déploiement.
operation
- add - Ajoute un nouveau contenu.
- addupdate - Ajoute ou met à jour un contenu en fonction de l'existence du contenu dans l'application.
- delete - Supprime un contenu.
- update - Met à jour un contenu existant.
L'option operation est nécessaire si le type de contenu est file ou modulefile. Si la valeur du type de contenu est app, la valeur de l'option operation doit être update. L'option contenturi est ignorée lorsque le type de contenu est app.
Exemple d'utilisation en mode de traitement par lots
Les exemples suivants indiquent comment utiliser les options de la commande update pour mettre à jour l'intégralité d'une application d'entreprise déployée :
$AdminApp update "IVT Application" app {-operation update
-contents app_server_root/installableApps/ivtApp.ear}
AdminApp.update('IVT Application', 'app', '[ -operation update
-contents app_server_root/installableApps/ivtApp.ear ]' )
Les exemples suivants indiquent comment utiliser les options pour permettre à la commande update de mettre à jour un fichier unique dans une application déployée :
A l'aide de Jacl :
![[Windows]](../images/windows.gif)
$AdminApp update app1 file {-operation update -contents
C:/apps/app1/my.xml -contenturi app1.jar/my.xml}
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$AdminApp update app1 file {-operation update
-contents /apps/app1/my.xml -contenturi app1.jar/my.xml}
A l'aide de la chaîne Jython :
![[Windows]](../images/windows.gif)
AdminApp.update('app1', 'file', '[-operation update -contents
C:/apps/app1/my.xml -contenturi app1.jar/my.xml]')
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.update('app1', 'file', '[-operation update
-contents /apps/app1/my.xml -contenturi app1.jar/my.xml]')
A l'aide de la liste Jython :
![[Windows]](../images/windows.gif)
AdminApp.update('app1', 'file', ['-operation', 'update', '-contents',
'C:/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.update('app1', 'file', ['-operation', 'update', '-contents',
'/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])
où AdminApp est l'objet de scriptage, update est la commande, app1 est le nom de l'application à mettre à jour, file est le type de contenu, operation est une option de la commande update, update est la valeur de l'option operation, contents est une option de la commande update, /apps/app1/my.xml est la valeur de l'option contents, contenturi est l'option de la commande update et app1.jar/my.xml est la valeur de l'option contenturi.
processEmbeddedConfig
L'option processEmbeddedConfig traite les données de configuration embarquées dans l'application. Cette option ne nécessite pas de valeur. Si le fichier EAR contient des données de configuration, cette option est le réglage par défaut. Dans le cas contraire, le réglage par défaut est l'option nonprocessEmbeddedConfig.
Ce paramètre concerne l'installation des fichiers EAR étendus. Vous obtenez un fichier EAR étendu quand vous exportez une application installée. Les fichiers EAR étendus embarquent une configuration qui est constituée de fichiers tels que resource.xml et variables.xml. Cette option charge une configuration embarquée à partir du fichier EAR et l'applique à la portée de l'application.
Si vous avez exporté l'application à partir d'une cellule autre que la cellule courante et que vous n'avez pas spécifié la variable $(CELL) pour l'option installed.ear.destination quand vous avez installé l'application, utilisez l'option nonprocessEmbeddedConfig pour décompacter le fichier EAR étendu dans le répertoire racine_profil/installedApps/nom_cellule_courante. Sinon, utilisez la présente option, processEmbeddedConfig, pour décompacter le fichier EAR étendu dans le répertoire racine_profil/installedApps/nom_cellule_origine, où nom_cellule_origine désigne la cellule où l'application a été installée au départ. Si, lors de la première installation de l'application, vous avez spécifié la variable $(CELL) dans l'option installed.ear.destination, l'installation décompacte le fichier EAR étendu dans le répertoire racine_profil/installedApps/nom_cellule_courante.
preCompileJSPs
L'option preCompileJSPs indique de précompiler les fichiers JSP. Cette option ne nécessite pas de valeur. La valeur par défaut est nopreCompileJSPs. Si vous souhaitez précompiler les fichiers JavaServer Pages, spécifiez-les en tant qu'élément de l'installation. Par défaut, les fichiers JavaServer Pages ne sont pas précompilés. L'option preCompileJSPs est ignorée lors du déploiement et les fichiers JavaServer Pages ne sont pas précompilés. L'indicateur est défini automatiquement à l'aide des outils d'assemblage.
reloadEnabled
L'option reloadEnabled indique les fichiers mis à jour seront recherchés sur le système de fichiers afin que les modifications soient rechargées de manière dynamique. Si cette option est activée, lorsque les classes de l'application sont modifiées, l'application est arrêtée et redémarrée afin de charger les classes mises à jour. Cette option n'est pas le réglage par défaut et elle ne nécessite pas de valeur. Le réglage par défaut est l'option noreloadEnabled.
reloadInterval
L'option reloadInterval indique la période pendant laquelle les fichiers mis à jour sont recherchés sur le système de fichiers afin que les modifications soient rechargées de manière dynamique. La plage valide correspond à une valeur supérieure à zéro. La valeur par défaut est 3 secondes.
SharedLibRelationship
L'option SharedLibRelationship attribue des ID d'actifs ou d'unités de composition en tant que bibliothèques partagées pour chaque module Java EE.
- Module : EJB3BNDBean.jar
- URI : EJB3BNDBean.jar,META-INF/ejb-jar.xml
- ID de relations : spécifiez l'ID des actifs ou des unités de composition (par exemple, [WebSphere:cuname=sharedLibCU1,cuedition=1.0] ou WebSphere:assetname=sharedLibAsset1.jar)
- Noms des unités de composition : vous pouvez éventuellement spécifier des noms d'unités de composition pour les ID de relations d'actifs. Le système utilise le nom de l'actif si vous ne spécifiez pas de nom d'unité de composition. []
- Correspondance de cible : [Yes]:
- Si vous spécifiez un actif, le système crée une unité de composition avec cet actif dans l'application de niveau métier à laquelle appartient l'application Java EE.
- Si vous indiquez une valeur pour les noms d'unités de composition, le système fait correspondre chaque nom avec les ID de relations correspondants.
- Si l'ID de relation est celui d'une unité de composition,le système ignore le nom de l'unité correspondante.
- Si l'ID de relation est celui d'un actif,le système crée l'unité de composition en utilisant le nom de l'unité correspondante.
Pour spécifier plusieurs ID d'actifs ou d'unités de composition, séparez chaque valeur par le signe Plus (+).
En utilisant la commande edit pour l'application Java EE, vous pouvez substituer à la relation un nouvel ensemble d'ID d'unités de composition, et vous pouvez également ajouter ou supprimer des relations existantes d'unités de composition. La commande edit ne permet pas de spécifier de relation d'actifs. Pour ajouter la relation, faites débuter l'ID de l'unité de composition par un signe Plus (+) et, pour le supprimer des relations existantes, indiquez un dièse (#). Ainsi, la syntaxe +cuname=cu2.zip ajoute à la relation l'unité de composition cu2. #cuname=cu1.zip+cuname=cu2.zip supprime de la relation les unités de composition cu1 et cu2.
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
$AdminApp install myapp.ear {-SharedLibRelationship {{EJB3BNDBean.jar
EJB3BNDBean.jar,META-INF/ejb-jar.xml WebSphere:cuname=sharedLibCU1 "" Yes}}}
En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-SharedLibRelationship {{.*
EJB3BNDBean.jar,.* WebSphere:cuname=sharedLibCU1 "" Yes}}}
En langage Jython :
AdminApp.install('myapp.ear', ['-SharedLibRelationship',
[['EJB3BNDBean,jar', 'EJB3BNDBean.jar,META-INF/ejb-jar.xml',
'WebSphere:cuname=sharedLibCU1,' '', 'Yes']]])
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-SharedLibRelationship', [['.*',
'EJB3BNDBean.jar,.*', 'WebSphere:cuname=sharedLibCU1', '', 'Yes']]]
server
- Installer une nouvelle application.
- Remplacer une application par une version mise à jour. Dans cette situation, cette option ne s'applique que si la mise à jour de l'application contient un nouveau module qui n'existe pas dans l'application déjà installée.
- Ajouter un nouveau module à une application existante.
Vous ne pouvez pas utiliser ensemble les options -cluster et -server. Si vous souhaitez déployer une application et spécifier le serveur HTTP lors du déploiement, afin que l'application apparaisse dans le fichier plugin-cfg.xml généré, vous devez d'abord installer l'application avec une cible de -cluster. Une fois que vous avez installé l'application, et avant d'enregistrer les changements, utilisez la commande edit de l'objet AdminApp pour ajouter le mappage supplémentaire au serveur Web.
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
{-server server1}
En langage Jython :
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
'[-server server1]')
target
L'option target indique la cible des fonctions d'installation de l'objet AdminApp. Vous trouverez ci-après un exemple d'option cible : WebSphere:cell=mycell,node=mynode,server=myserver
Exemple d'utilisation en mode de traitement par lots
L'exemple suivant spécifie server1 comme serveur cible pour l'installation de l'application :
A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
{-appname MyApp -target WebSphere:cell=myCell,node=myNode,server=server1}
En langage Jython :
AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
["-appname", "MyApp", "-target", "WebSphere:cell=myCell,node=myNode,server=server1"])
L'exemple suivant spécifie server1 et server2 comme serveurs cible pour l'installation de l'application :
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
{-appname MyApp -target
WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2}
AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
["-appname", "MyApp", "-target",
"WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2"])
L'exemple suivant supprime server3 de l'application installée :
$AdminApp install
app_server_root/binaries/DefaultApplication.ear {-appname MyApp
-target -WebSphere:cell=GooddogCell,node=BaddogNode,server=server3
-update -update.ignore.old}
AdminApp.install("app_server_root/binaries/DefaultApplication.ear",
["-appname", "MyApp",
"-target", "-WebSphere:cell=GooddogCell,node=BaddogNode,server=server3",
"-update", "-update.ignore.old"])
L'exemple suivant ajoute server4 à l'application installée :
$AdminApp update app {-appname MyApp
-target +WebSphere:cell=GooddogCell,node=GooddogNode,server=server4
-contents app_server_root/binaries/DefaultApplication.ear
-operation update -update.ignore.old}
AdminApp.update("app", ["-appname", "MyApp",
"-target", "+WebSphere:cell=GooddogCell,node=GooddogNode,server=server4",
"-contents", "app_server_root/binaries/DefaultApplication.ear",
"-operation", "update", "-update.ignore.old"])
update
L'option update met à jour l'application installée à l'aide d'une nouvelle version du fichier EAR. Cette option ne nécessite pas de valeur.
L'application à mettre à jour, spécifiée par l'option appname, doit déjà être installée dans la configuration WebSphere Application Server. L'action de mise à jour fusionne les liaisons de la nouvelle version avec celles de l'ancienne version, désinstalle l'ancienne version puis installe la nouvelle. Les informations de liaison de la nouvelle version du fichier EAR ou du module ont la préférence par rapport aux informations correspondantes de l'ancienne version. Si un élément de liaison est manquant dans la nouvelle version, l'élément correspondant de l'ancienne version est utilisé.
update.ignore.new
L'option update.ignore.new indique que, lors de la mise à jour, les informations de liaison de l'ancienne version de l'application ou du module sont préférées par rapport aux informations de liaison correspondantes de la nouvelle version. Si un élément de liaison est manquant dans l'ancienne version, l'élément de la nouvelle version est utilisé. C'est-à-dire que les liaisons de la nouvelle version de l'application ou du module sont ignorées si une liaison existe dans l'ancienne version. Autrement, les nouvelles liaisons sont acceptées et non pas ignorées. Cette option ne nécessite pas de valeur.
- L'option update pour la commande install.
- Le type de contenu modulefile ou app pour la commande update.
update.ignore.old
- L'option update pour la commande install.
- Le type de contenu modulefile ou app pour la commande update.
useAutoLink
L'option useAutoLink permet de résoudre automatiquement les références d'EJB (Enterprise JavaBeans) à partir des versions de modules EJB antérieures à la version 3.0, et de modules Web antérieures à la version 2.4. Si vous activez l'option useAutoLink, vous pouvez, si vous le voulez, spécifier le nom JNDI pour l'option MapEJBRefToEJB. Chacun des modules de l'application doit partager une cible commune pour activer la prise en charge d'autolink.
Exemple d'utilisation en mode de traitement par lots
A l'aide de Jacl :
![[Windows]](../images/windows.gif)
$AdminApp install C:/myapp.ear {-useAutoLink}
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$AdminApp install /myapp.ear {-useAutoLink}
En langage Jython :
![[Windows]](../images/windows.gif)
AdminApp.install('C:/myapp.ear','[-useAutoLink]')
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
AdminApp.install('myapp.ear','[-useAutoLink]')
usedefaultbindings
L'option usedefaultbindings indique que les liaisons par défaut doivent être utilisées pour l'installation. Cette option ne nécessite pas de valeur. Le réglage par défaut est nousedefaultbindings.
Pour utiliser le port d'écoute existant au lieu d'utiliser ou de créer une spécification d'activation, déterminez si la version JAR d'EJB est inférieure à 2.1. Le système crée et utilise automatiquement une spécification d'activation que vous spécifiez à l'aide de l'option -usedefaultbindings pour déployer une application. Si une spécification d'activation existe, le système ignore le port d'écoute, mais utilise la spécification d'activation. Pour déployer une application avec une version JAR d'EJB supérieure ou égale à 2.1 utilisant les ports d'écoute définis au lieu d'une nouvelle spécification d'activation, attribuez la valeur true à la propriété système com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting dans le fichier wsadmin.properties figurant dans le répertoire des propriétés du profil concerné.
useMetaDataFromBinary
L'option useMetaDataFromBinary indique que les métadonnées utilisées lors de l'exécution, par exemple, les descripteurs de déploiement, les liaisons, les extensions, etc. proviennent du fichier EAR. Cette option ne nécessite pas de valeur. La valeur par défaut est nouseMetaDataFromBinary, qui signifie que les métadonnées utilisées lors de l'exécution proviennent du référentiel de configuration.
validateinstall
- off - Spécifie l'absence de validation de déploiement d'application. Il s'agit de la valeur par défaut.
- warn - Effectue une validation de déploiement d'application et poursuit le processus de déploiement d'application même si des messages d'avertissement ou d'erreur ont été générés.
- fail - Effectue une validation de déploiement d'application mais ne poursuit pas le processus de déploiement d'application si des messages d'avertissement ou d'erreur sont générés.
validateSchema
L'option validateSchema indique qu'il faut valider les descripteurs de déploiement par rapport aux schémas de descripteur de déploiement Java EE. Lorsque cette option de déploiement d'application est sélectionnée, le produit analyse chaque descripteur de déploiement pour déterminer la version de la spécification Java EE pour le descripteur de déploiement, sélectionne le schéma approprié, puis vérifie le descripteur de déploiement par rapport au schéma du descripteur de déploiement Java EE. Les erreurs de validation génèrent des messages d'erreur.
Cette option ne nécessite pas de valeur. La valeur par défaut est novalidateSchema. Par défaut, l'option validateSchema est ignorée pendant le déploiement et le produit ne valide pas les descripteurs de déploiement.
verbose
L'option verbose permet l'affichage de messages supplémentaires au cours de l'installation. Cette option ne nécessite pas de valeur.
WebServicesClientBindDeployedWSDL
L'option WebServicesClientBindDeployedWSDL identifie le service Web client que vous modifiez. Les zones de portée sont les suivantes : Module, EJB et Service Web. La valeur unique variable pour cette tâche est le nom de fichier WSDL déployé. Elle indique le langage de description de services Web (WSDL) utilisé par le client.
La zone Module identifie le module EJB ou Web dans l'application. Si le module est un bean enterprise, la zone EJB identifie un bean enterprise déterminé dans le module. La zone Service Web identifie le service Web dans le bean enterprise ou dans le module d'application Web. Cet identifiant correspond à l'attribut wsdl:service dans le fichier WSDL, dont le préfixe est service/. Exemple : service/WSLoggerService2.
L'attribut WSDL déployé nomme un fichier WSDL par rapport au module client. Voici un exemple de fichier WSDL déployé pour une application Web : WEB-INF/wsdl/WSLoggerService.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar
AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl}}}
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{.* .* .*
META-INF/wsdl/DeployedWsdl1.wsdl}}}
$AdminApp install WebServicesSamples.ear {
-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
META-INF/wsdl/DeployedWsdl1.wsdl}}
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml
jndi1 "" "" } { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample EJB"
com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
jndi3 "" "" }}
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
{ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
{ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} }
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindDeployedWSDL
[[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl]]]')
$AdminApp install WebServicesSamples.ear', '[
-WebServicesClientBindDeployedWSDL [[ AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
META-INF/wsdl/DeployedWsdl1.wsdl ]]
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml
jndi1 "" "" ] [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
jndi3 "" "" ]]
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
[ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
[ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindDeployedWSDL',
['.*', '.*', '.*', 'META-INF/wsdl/DeployedWsdl1.wsdl']]])
WebServicesClientBindPortInfo
L'option WebServicesClientBindPortInfo identifie le port d'un service Web client que vous modifiez. Les zones de portée sont les suivantes : Module, EJB, Service Web et Port. Les valeurs modifiables de cette tâche comprennent Sync Timeout, BasicAuth ID, BasicAuth Password, SSL Config et Overridden Endpoint URI. Les zones Authentification de base et Secure Sockets Layer (SSL) concernent la sécurité au niveau du transfert et non au niveau des services Web.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{AddressBookW2JE.jar
AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig
http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}}
$AdminApp install WebServicesSamples.ear {
-WebServicesClientBindPortInfo {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig
http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml
jndi1 "" "" }
{ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample
EJB" com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
jndi3 "" "" }}
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
{ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
{ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} }
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{.* .* .* .* 3000
newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}}
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPortInfo
[[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID
newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS]]]')
AdminApp.install('WebServicesSamples.ear', '[
-WebServicesClientBindPortInfo [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS
3000 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS ]]
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" ]
[ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
jndi3 "" "" ]]
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
[ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
[ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPortInfo',
[['.*', '.*', '.*', '.*', '3000', 'newHTTP_ID', 'newHTTP_pwd', 'sslAliasConfig',
'http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS']]])
WebServicesClientBindPreferredPort
- Type de port - QName ("{namespace} localname") d'un type de port défini par l'attribut wsdl:portType dans le fichier WSDL qui identifie une interface.
- Port - QName d'un port défini par l'attribut wsdl:port dans un attribut wsdl:service dans un fichier WSDL qui identifie une implémentation qui prévaut.
Exemple d'utilisation en mode de traitement par lots
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort
{{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort}}}
$AdminApp install WebServicesSamples.ear
{-WebServicesClientBindPreferredPort {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
WSLoggerJMS WSLoggerJMSPort}}
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" }
{ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample EJB"
com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
jndi3 "" "" }}
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
{ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
{ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} }
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort {{.* .* .* .*
WSLoggerJMSPort}}}
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPreferredPort
[[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort]]]')
AdminApp.install('WebServicesSamples.ear',
'[ -WebServicesClientBindPreferredPort
[[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort ]]
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" ]
[ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
jndi3 "" "" ]]
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
[ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
[ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPreferredPort',
[['.*', '.*', '.*', '.*', 'WSLoggerJMSPort']]])
WebServicesServerBindPort
L'option WebServicesServerBindPort définit deux attributs d'un port de service Web. Les valeurs non modifiables identifient le port d'un service Web que vous modifiez. Les zones de portée sont les suivantes : Module, Service Web et Port. Les valeurs modifiables incluent WSDL Service Name et Scope.
La portée détermine le cycle de vie de l'implémentation du bean Java. Les valeurs admises comprennent Request (nouvelle instance pour chaque demande), Application (une instance pour chaque Web-app) et Session (nouvelle instance pour chaque session HTTP).
L'attribut scope ne concerne pas les services Web transférés par un service JMS (Java Message Service). L'attribut de la portée ne s'applique pas aux beans enterprise.
Le nom de service WSDL identifie un service lorsque plusieurs services possèdent le même nom de port. Le nom de service WSDL est représenté sous forme de chaîne QName. Par exemple, {namespace}localname .
Exemple d'utilisation en mode de traitement par lots
$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort
{{AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS {} Session}}}
$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort
{{.* WSClientTestService WSClientTest Request} {.* StockQuoteService StockQuote Application}
{.* StockQuoteService StockQuote2 Session}}}
AdminApp.install('WebServicesSamples.ear', '[-WebServicesServerBindPort
[[AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS "" Session]]]')
AdminApp.install('WebServicesSamples.ear', ['-WebServicesServerBindPort',
[['.*', 'WSClientTestService', 'WSClientTest', 'Request'],
['.*', 'StockQuoteService', 'StockQuote', 'Application'],
['.*', 'StockQuoteService', 'StockQuote2', 'Session']]])
WebServicesClientCustomProperty
L'option WebServicesClientCustomProperty prend en charge la configuration du paramètre nom/valeur pour la description du fichier de liaison client d'un service Web. Les valeurs non modifiables identifient le port du service Web que vous modifiez. Les zones de portée sont les suivantes : Module, Service Web et Port. Les valeurs modifiables incluent name et value.
Le format des valeurs name et value inclut une chaîne représentant plusieurs paires nom/valeur et utilisant le signe + comme séparateur. Par exemple, name = "n1+n2+n3" value = "v1+v2+v3" génère les paires nom/valeur {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}
Exemple d'utilisation en mode de traitement par lots
$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty
{{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest service/StockQuoteService
STockQuote propname1 propValue1}
{ejbclientonly.jar Exchange service/STockQuoteService STockQuote propname2 propValue2}}}
$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty
{{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest .* .* propname1 propValue1}
{ejbclientonly.jar Exchange .* .* propname2 propValue2}}}
AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty',
[['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest',
'service/StockQuoteService', 'STockQuote', 'propname1', 'propValue1'],
['ejbclientonly.jar', 'Exchange', 'service/STockQuoteService', 'STockQuote',
'propname2', 'propValue2']]])
AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty',
[['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest',
'.*', '.*', 'propname1', 'propValue1'],
['ejbclientonly.jar', 'Exchange', '.*', '.*', 'propname2', 'propValue2']]])
WebServicesServerCustomProperty
L'option WebServicesServerCustomProperty prend en charge la configuration du paramètre nom/valeur pour la description du fichier de liaison du serveur d'un service Web. Les zones de portée sont les suivantes : Module, EJB et Service Web. Les valeurs modifiables pour cette tâche incluent name et value.
Le format de ces valeurs inclut une chaîne représentant plusieurs paires nom/valeur en utilisant le signe "+" comme séparateur. Par exemple, name = "n1+n2+n3" value = "v1+v2+v3" génèrent les paires nom/valeur {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}
Exemple d'utilisation en mode de traitement par lots
$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty
{{AddressBookW2JE.jar AddressBookService AddressBook
com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}
$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty
{{.* .* .* com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}
AdminApp.edit ( 'WebServicesSamples', '[ -WebServicesServerCustomProperty
[[AddressBookW2JE.jar AddressBookService AddressBook
com.ibm.websphere.webservices.http.responseContentEncoding deflate]]]')
AdminApp.edit ( 'WebServicesSamples', ['-WebServicesServerCustomProperty', [['.*', '.*',
'.*', 'com.ibm.websphere.webservices.http.responseContentEncoding', 'deflate']]])