Opciones para los mandatos install, installInteractive, edit, editInteractive, update y updateInteractive del objeto AdminApp con scripts wsadmin
En este tema se listan las opciones disponibles para los mandatos install, installInteractive, edit, editInteractive, update y updateInteractive del objeto AdminApp.
Puede utilizar los mandatos para el objeto AdminApp para instalar, editar, actualizar y gestionar las configuraciones de aplicación. En este tema se proporcionan opciones adicionales para utilizar con los mandatos install, installInteractive, edit, editInteractive, update y updateInteractive para administrar las aplicaciones. Las opciones listadas en este tema se aplican a todos estos mandatos, excepto cuando se especifique de otra forma.
Puede establecer o actualizar un valor de configuración mediante las opciones de la modalidad por lotes. Para identificar qué objeto de configuración se va a establecer o actualizar, se utilizan los valores de los campos de sólo lectura para buscar el objeto de configuración correspondiente. Todos los valores de los campos de sólo lectura tienen que coincidir con un objeto de configuración existente o, de lo contrario, el mandato no se ejecutará correctamente.
Puede utilizar la coincidencia de patrones para simplificar la tarea de suministrar los valores necesarios para determinadas opciones complejas. La coincidencia de patrones sólo se aplica a campos que son obligatorios y de solo lectura.
- ActSpecJNDI
- allowDispatchRemoteInclude
- allowPermInFilterPolicy
- allowServiceRemoteInclude
- appname
- BackendIdSelection
- BindJndiForEJBBusiness
- BindJndiForEJBMessageBinding
- BindJndiForEJBNonMessageBinding
- blaname
- buildVersion
- cell
- clientMode
- clúster
- contents
- contenturi
- contextroot
- CorrectOracleIsolationLevel
- CorrectUseSystemIdentity
- createMBeansForResources
- CtxRootForWebMod
- personalizada
- 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 (en desuso)
- 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 (en desuso)
- 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
- node
- nocreateMBeansForResources
- nodeployejb
- nodeployws
- nodistributeApp
- noenableClientModule
- noreloadEnabled
- nopreCompileJSPs
- noprocessEmbeddedConfig
- nouseAutoLink
- nouseMetaDataFromBinary
- nousedefaultbindings
- novalidateSchema
- operación
- processEmbeddedConfig
- preCompileJSPs
- reloadEnabled
- reloadInterval
- SharedLibRelationship
- servidor
- target
- update
- update.ignore.new
- update.ignore.old
- useAutoLink
- usedefaultbindings
- useMetaDataFromBinary
- validateinstall
- validateSchema
- verbose
- WebServicesClientBindDeployedWSDL
- WebServicesClientBindPortInfo
- WebServicesClientBindPreferredPort
- WebServicesServerBindPort
- WebServicesClientCustomProperty
- WebServicesServerCustomProperty
ActSpecJNDI
- RARModule: <nombre módulo rar>
- uri: <nombre rar>,META-INF/ra.xml
- Identificador de objeto: <Tipoescuchamensaje>
- Nombre JNDI: null
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$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
La opción allowDispatchRemoteInclude habilita una aplicación de empresa para que asigne solicitudes include a recursos a través de módulos web que están en JVM (Java Virtual Machine) diferentes en un entorno de nodos gestionado a través del mecanismo del asignador de solicitudes estándar.
Uso del ejemplo de modalidad de proceso por lotes
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
La opción allowPermInFilterPolicy especifica que el servidor de aplicaciones debe continuar con el proceso del despliegue de aplicaciones, aún cuando la aplicación contenga permisos de política que están en la política de filtros. Esta opción no necesita obligatoriamente un valor.
allowServiceRemoteInclude
La opción allowServiceRemoteInclude permite que una aplicación de empresa dé servicio a una solicitud include con la opción allowDispatchRemoteInclude establecida en true.
Uso del ejemplo de modalidad de proceso por lotes
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
La opción appname especifica el nombre de la aplicación. El valor predeterminado es el nombre de visualización de la aplicación.
BackendIdSelection
La opción BackendIdSelection especifica el ID de programa de fondo para los módulos del archivador Java de enterprise bean (JAR) que tienen beans CMP (persistencia gestionada por contenedor). Un módulo JAR de enterprise bean puede dar soporte a varias configuraciones de programa de fondo, tal como se especifica utilizando Application Assembly Tool. Utilice esta opción para cambiar el ID de programa de fondo durante la instalación.
Uso del ejemplo de modalidad de proceso por lotes
$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
La opción BindJndiForEJBBusiness enlaza módulos EJB con interfaces de empresa con nombres JNDI. Asegúrese de que cada módulo EJB con interfaces de empresa se enlaza con un nombre JNDI.
- Módulo: Ejb1
- Bean: MessageBean
- URI: sample.jar,META-INF/ejb-jar.xml
- Interfaz de empresa: com.ibm.sample.business.bnd.LocalTargetOne
- Nombre JNDI: []: ejblocal:ejb/LocalTargetOne
Si especifica el nombre JNDI de recurso de destino con la opción BindJndiForEJBNonMessageBinding, no especifique un nombre JNDI de interfaz de empresa en la opción BindJndiForEJBBusiness. Si no especifica el nombre JNDI de recurso de destino, especifique un nombre JNDI de interfaz de empresa. Si no especifica un nombre JNDI de interfaz de empresa, el tiempo de ejecución proporciona un contenedor por omisión.
Para obtener una vista sin interfaz, el valor de interfaz de empresa debe ser una serie vacía ("").
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$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
La opción BindJndiForEJBMessageBinding enlaza enterprise beans controlados por mensajes con nombres de puerto de escucha o para nombres JNDI (Java Naming and Directory Interface). Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea. Cuando se enlaza un enterprise bean controlado por mensajes con un nombre JNDI de especificación de activación, también puede especificarse el nombre JNDI de destino y el alias de autenticación.
Cada elemento de la opción BindJndiForEJBMessageBinding consta de los campos siguientes: EJBModule, EJB, uri, listenerPort, JNDI, jndi.dest y actspec.auth. A algunos de estos campos se les pueden asignar valores: listenerPort, JNDI, jndi.dest y actspec.auth
- Módulo: Ejb1
- Bean: MessageBean
- URI: ejb-jar-ic.jar,META-INF/ejb-jar.xml
- Puerto de escucha: [null]:
- Nombre JNDI: [eis/MessageBean]:
- Nombre JNDI de destino: [jms/TopicName]:
- Alias de autenticación ActivationSpec: [null]:
Si no se proporciona una propiedad de configuración de activación destinationLookup como una anotación o en el descriptor de despliegue y no hay un nombre JNDI de destino en el archivo de enlace de IBM, el nombre JNDI de destino predeterminado se recopila de la referencia del mensaje correspondiente.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$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
La opción BindJndiForEJBNonMessageBinding enlaza los enterprise beans con los nombres JNDI (Java Naming and Directory Interface). Asegúrese de que todos los enterprise bean controlados por mensajes de la aplicación o el módulo estén enlazados a nombres de la JNDI. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
- Módulo: Ejb1
- Bean: MessageBean
- URI: ejb-jar-ic.jar,META-INF/ejb-jar.xml
- Nombre JNDI de recurso de destino: [com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC]
- Nombre JNDI de inicio local: [null]
- Nombre JNDI de inicio remoto: [null]
Existen limitaciones especiales para los módulos de Enterprise JavaBeans (EJB) 3.0 y posteriores. Si especifica el nombre JNDI de recurso de destino, no especifique los nombres JNDI de inicio local o de inicio remoto. Tampoco puede especificar el campo JNDI para interfaces de empresa en la opción BindJndiForEJBBusiness. Si no especifica el nombre JNDI de recurso de destino, los campos de nombre JNDI de inicio local y remoto son opcionales. Si no especifica nombres JNDI de inicio local y remoto, el tiempo de ejecución proporciona un contenedor predeterminado.
Si no utiliza módulos EJB 3.0, debe especificar el nombre JNDI de recurso de destino.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
En 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 raíz_servidor_aplicapps/myapps/installableApps/JobbankTargetEJBApp.ear
{-BindJndiForEJBNonMessageBinding {{.* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
ejb/com/app/ResumeBank/ResumeBank "" "" }}}
Utilizando 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('raíz_servidor_aplic/apps/myapps/installableApps/JobbankTargetEJBApp.ear',
'[ -BindJndiForEJBNonMessageBinding [[ .* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
ejb/com/app/ResumeBank/ResumeBank "" "" ]] ]' )
blaname
Utilice la opción blaname para especificar el nombre de la aplicación de nivel de negocio en la que el sistema crea la aplicación Java EE. Esta opción es opcional. Si no especifica un valor, el sistema establece el nombre como el nombre de aplicación Java EE. Esta opción sólo está disponible con el mandato install.
buildVersion
La opción buildVersion visualiza la versión de build de un archivo EAR de la aplicación. Esta opción no se puede modificar porque es de solo lectura. Esta opción devuelve la información de la versión de compilación para un archivo EAR de la aplicación si ha especificado la versión de compilación en el archivo EAR de la aplicación MANIFEST.MF.
cell
La opción cell especifica el nombre de célula para instalar o actualizar toda una aplicación o para actualizar una aplicación con objeto de añadir un módulo nuevo. Si desea actualizar toda una aplicación, esta opción sólo se aplica si la aplicación contiene un nuevo módulo que no existe en la aplicación instalada.
Uso del ejemplo de modalidad de proceso por lotes
En Jacl:
![[Windows]](../images/windows.gif)
$AdminApp install "C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell
nombre_célula}
![[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 nombre_célula}
Utilizando Jython:
![[Windows]](../images/windows.gif)
AdminApp.install('C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell
nombre_célula]')
![[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 nombre_célula]')
clientMode
La opción clientMode especifica si se van a desplegar módulos de cliente en un destino de despliegue aislado (isolated), un nodo federado de un gestor de despliegue (federated) o un servidor de aplicaciones (server_deployed). Si especifica esta opción, instale los módulos de cliente solo en un destino de despliegue de la versión 8.0 o posterior.
El valor predeterminado es isolated.
La selección de la modalidad de despliegue del cliente afecta a cómo se manejan las búsquedas java:. Todos los espacios de nombres de URL Java (global, aplicación, módulo y componente) son locales en los procesos de cliente aislada. Los espacios de nombres residen en procesos de cliente desplegados por servidor y federados. El servidor o clúster elegido como destino para un módulo de cliente determina el lugar en el que se crean los espacios de nombres. Todas las búsquedas java: para módulos de cliente desplegados por servidor o federados se dirigen al servidor de destino o clúster. El módulo de cliente no se ejecuta realmente en el servidor de destino o clúster. Varias instancias del mismo módulo de cliente compartirán el espacio de nombres de modalidades desplegadas de servidor y federadas. Seleccionar la modalidad federada es simplemente una declaración de intención para lanzar el módulo de cliente mediante JNLP (Java Network Launching Protocol), pero los mecanismos JNDI (Java Naming and Directory Interface) de las modalidades desplegadas de servidor y federadas son los mismos.
clúster
La opción cluster especifica el nombre de clúster para instalar o actualizar toda una aplicación o para actualizar una aplicación con objeto de añadir un módulo nuevo. Esta opción sólo se aplica en el entorno de WebSphere Application Server, Network Deployment. Si desea actualizar toda una aplicación, esta opción sólo se aplica si la aplicación contiene un nuevo módulo que no existe en la aplicación instalada. Las opciones -cluster y -server no se pueden utilizar juntas.
Si desea desplegar una aplicación y especificar el servidor HTTP durante el despliegue para que la aplicación aparezca en el archivo plugin-cfg.xml generado, en primer lugar, debe instalar la aplicación con un destino de -cluster. Después de instalar la aplicación y antes de guardar, utilice el mandato edit del objeto AdminApp para añadir la correlación adicional con el servidor web.
Uso del ejemplo de modalidad de proceso por lotes
En 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 Nombreclúster}
Utilizando 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 Nombreclúster]')
contents
La opción contents especifica el archivo que incluye el contenido que desea actualizar. Por ejemplo, dependiendo del tipo de contenido, el archivo puede ser un archivo EAR, un módulo, un zip parcial o un solo archivo. La vía de acceso del archivo debe ser local para el cliente del script. La opción contents es necesaria, a menos que haya especificado la opción delete.
contenturi
La opción contenturi especifica el URI del archivo que añade, actualiza o elimina de una aplicación. Esta opción sólo se aplica al mandato update. La opción contenturi es necesaria si el tipo de contenido es file o modulefile. Esta opción se ignora para otros tipos de contenido.
contextroot
La opción contextroot especifica el directorio raíz de contexto que se va utilizar al instalar un archivo WAR (web application archive) autónomo.
CorrectOracleIsolationLevel
La opción CorrectOracleIsolationLevel especifica el nivel de aislamiento para el proveedor tipo Oracle. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea. El último campo de cada entrada especifica el nivel de aislamiento. Los valores válidos del nivel de aislamiento son 2 o 4.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Sólo es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$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
La opción CorrectUseSystemIdentity sustituye RunAs System por RunAs Roles. Los enterprise beans que instala contienen una identidad del sistema RunAs. De modo opcional, puede cambiar esta identidad por un rol RunAs. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$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
La opción createMBeansForResources especifica que se crean MBeans para todos los recursos como, por ejemplo, servlets, archivos JSP (JavaServer Pages) y enterprise beans, que se definen en una aplicación cuando se inicia la aplicación en un destino de despliegue. Esta opción no necesita obligatoriamente un valor. El valor predeterminado es la opción nocreateMBeansForResources.
CtxRootForWebMod
- Módulo web: xxx
- URI: xxx
- ContextRoot: <raíz contexto>
Uso del ejemplo de modalidad de proceso por lotes
En Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
{-appname ivtApp -CtxRootForWebMod
{{"IVT Application" ivt_app.war,WEB-INF/web.xml /mycontextroot}}}
$AdminApp install myapp.ear {-appname MyApp -CtxRootForWebMod {{.* .* /mycontextroot}}}
Utilizando Jython:
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
['-appname', 'ivtApp ', '-CtxRootForWebMod',
[["IVT Application", 'ivt_app.war,WEB-INF/web.xml', '/mycontextroot']]])
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-CtxRootForWebMod',
[['.*', '.*', '/mycontextroot']]])
personalizada
La opción custom especifica un par nombre-valor utilizando el formato nombre=valor. Utilice la opción custom para pasar opciones a las extensiones de despliegue de aplicaciones. Consulte la documentación sobre extensiones de despliegue de aplicaciones para conocer las opciones custom disponibles.
CustomActivationPlan
La opción CustomActivationPlan especifica los componentes del tiempo de ejecución que se debe añadir a, o eliminar de, los componentes predeterminados del tiempo de ejecución que se utilizan para ejecutar la aplicación. Utilice esta opción sólo si el servidor de aplicaciones no puede obtener todos los componentes de tiempo de ejecución necesarios inspeccionando la aplicación.
Uso del ejemplo de modalidad de proceso por lotes
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 ""]]')
Component | valor de WS_ComponentToAdd |
---|---|
contenedor EJB | WS_EJBContainer |
Contenedor de portlet | WS_PortletContainer |
JSF (JavaServer Faces) | WS_JSF |
Contenedor SIP | WS_SipContainer |
Servicio de ámbito de compensación | WS_Compensation |
Perfil de aplicación | WS_AppProfile |
Sesión de actividad | WS_ActivitySession |
Internacionalización | WS_I18N |
Beans de arranque | WS_StartupService |
DataSourceFor10CMPBeans
La opción DataSourceFor10CMPBeans especifica los orígenes de datos opcionales para los beans 1.x CMP (persistencia gestionada por contenedor) individuales. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
La correlación de un origen de datos específico con un bean CMP altera temporalmente el origen de datos predeterminado del módulo que contiene el enterprise bean. Cada elemento de la opción DataSourceFor10CMPBeans está formado por los siguientes campos: EJBModule, EJB, uri, JNDI, userName, password, login.config.name y auth.props. De estos campos, se pueden asignar valores a los siguientes: JNDI, userName, password, login.config.name y auth.props.
- Módulo: Increment CMP 1.1 EJB
- Bean: IncCMP11
- URI: IncCMP11.jar,META-INF/ejb-jar.xml
- Nombre JNDI de recurso de destino: [DefaultDatasource]:
- Nombre de usuario: [null]:
- Contraseña: [null]:
- Nombre de configuración de inicio de sesión: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
- Propiedades: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
Si login.config.name se establece en DefaultPrincipalMapping, se crea una propiedad con el nombre com.ibm.mapping.authDataAlias. El valor de la propiedad lo establece auth.props. Si login.config.name no se establece en DefaultPrincipalMapping, auth.props puede especificar varias propiedades. El formato de la serie es websphere:name= <nombre1>,value=<valor1>,description=<descripción1>. Para especificar varias propiedades utilice el signo más (+) .
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
En 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}}}
Utilizando Jacl con coincidencia de patrones:
![[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}}}
Utilizando 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']]])
Utilizando Jython con coincidencia de patrones:
![[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
La opción DataSourceFor20CMPBeans especifica los orígenes de datos opcionales para los beans 2.x CMP (persistencia gestionada por contenedor (CMP)individuales. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
La correlación de un origen de datos específico con un bean CMP altera temporalmente el origen de datos predeterminado del módulo que contiene el enterprise bean. Cada elemento de la opción DataSourceFor20CMPBeans está formado por los siguientes campos: EJBModule, EJB, uri, JNDI, resAuth, login.config.name y auth.props. De estos campos, se pueden asignar valores a los siguientes: JNDI, resAuth, login.config.name y auth.props.
- Módulo: Increment enterprise bean
- Bean: Increment
- URI: Increment.jar,META-INF/ejb-jar.xml
- Nombre JNDI de recurso de destino: [null]:
- Autorización de recursos: [Por aplicación]:
- Nombre de configuración de inicio de sesión: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
- Propiedades: []: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
Si login.config.name se establece en DefaultPrincipalMapping, se crea una propiedad con el nombre com.ibm.mapping.authDataAlias. El valor de la propiedad lo establece auth.props. Si login.config.name no se establece en DefaultPrincipalMapping, auth.props puede especificar varias propiedades. El formato de la serie es websphere:name= <nombre1>,value=<valor1>,description=<descripción1>. Para especificar varias propiedades utilice el signo más (+) .
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Sólo es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$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
La opción DataSourceFor10EJBModules especifica el origen de datos predeterminado para el módulo de enterprise bean que contiene los beans 1.x CMP (persistencia gestionada por contenedor. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
Cada elemento de la opción DataSourceFor10EJBModules está formado por los campos siguientes: EJBModule, uri, JNDI, userName, password, login.config.name y auth.props. De estos campos, se pueden asignar valores a los siguientes: JNDI, userName, password, login.config.name y auth.props.
- Módulo: Increment CMP 1.1 enterprise bean
- uri: IncCMP11.jar,META-INF/ejb-jar.xml
- Nombre JNDI de recurso de destino: [DefaultDatasource]:
- Nombre de usuario: [null]:
- Contraseña: [null]:
- Nombre de configuración de inicio de sesión: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
- Propiedades: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
Si login.config.name se establece en DefaultPrincipalMapping, se crea una propiedad con el nombre com.ibm.mapping.authDataAlias. El valor de la propiedad lo establece auth.props. Si login.config.name no se establece en DefaultPrincipalMapping, auth.props puede especificar varias propiedades. El formato de la serie es websphere:name= <nombre1>,value=<valor1>,description=<descripción1>. Para especificar varias propiedades utilice el signo más (+) .
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$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
La opción DataSourceFor20EJBModules especifica el origen de datos predeterminado para el módulo de enterprise bean 2.x que contiene los beans 2.x CMP (persistencia gestionada por contenedor). Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
Cada elemento de la opción DataSourceFor20EJBModules está formado por los siguientes campos: EJBModule, uri, JNDI, resAuth, login.config.name y auth.props. De estos campos, se pueden asignar valores a los siguientes: JNDI, resAuth, login.config.name, auth.props y propiedades del origen de datos ampliado.
- Módulo: Increment enterprise bean
- URI: Increment.jar,META-INF/ejb-jar.xml
- Nombre JNDI de recurso de destino: [DefaultDatasource]:
- Autorización de recursos: [Por aplicación]:
- Nombre de configuración de inicio de sesión: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
- Propiedades: []: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
- Propiedades del origen de datos ampliado: []: Utilice esta opción para que un origen de datos que emplee la agrupación heterogénea pueda conectarse a una base de datos DB2. El patrón para la propiedad es property1=value1+property2=value2.
El último campo de cada entrada de esta tarea especifica el valor de la autorización de recursos. Los valores válidos para la autorización de recursos son por fábrica de conexiones o contenedor.
Si login.config.name se establece en DefaultPrincipalMapping, se crea una propiedad con el nombre com.ibm.mapping.authDataAlias. El valor de la propiedad lo establece auth.props. Si login.config.name no se establece en DefaultPrincipalMapping, auth.props puede especificar varias propiedades. El formato de la serie es websphere:name= <nombre1>,value=<valor1>,description=<descripción1>. Para especificar varias propiedades utilice el signo más (+) .
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren actualizarse.
Uso del ejemplo de modalidad de proceso por lotes
$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\"
En la sustitución de mandatos, refiérase a la variable tal como se muestra en el ejemplo siguiente:"clientApplicationInformation=value1,value2" with "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
La opción defaultbinding.cf.jndi especifica el nombre JNDI (Java Naming and Directory Interface) para la fábrica de conexiones predeterminada.
defaultbinding.cf.resauth
La opción defaultbinding.cf.resauth especifica la autorización RESAUTH para la fábrica de conexiones.
defaultbinding.datasource.jndi
La opción defaultbinding.datasource.jndi especifica el nombre JNDI (Java Naming and Directory Interface) para el origen de datos predeterminado.
defaultbinding.datasource.password
La opción defaultbinding.datasource.password especifica la contraseña para el origen de datos predeterminado.
defaultbinding.datasource.username
La opción defaultbinding.datasource.username especifica el nombre de usuario para el origen de datos predeterminado.
defaultbinding.ee.defaults

defaultbinding.ejbjndi.prefix
La opción defaultbinding.ejbjndi.prefix especifica el prefijo para el nombre JNDI (Java Naming and Directory Interface) de enterprise bean.
Para utilizar la opción
defaultbinding.ejbjndi.prefix de la plataforma z/OS, también debe especificar la opción
usedefaultbindings. Si no especifica la opción usedefaultbindings, el valor predeterminado es la opción
nousedefaultbindings.
defaultbinding.force
La opción defaultbinding.force especifica que los enlaces predeterminados alteran temporalmente los enlaces actuales.
defaultbinding.strategy.file
La opción defaultbinding.strategy.file especifica un archivo de estrategia de enlaces predeterminados personalizado.
defaultbinding.virtual.host
La opción defaultbinding.virtual.host especifica el nombre predeterminado para un host virtual.
depl.extension.reg (en desuso)

deployejb
La opción deployejb especifica que se ejecute la herramienta EJBDeploy durante la instalación. Esta opción no necesita obligatoriamente un valor. EJBDeploy se ejecuta durante la instalación de los módulos EJB 1.x o 2.x. La herramienta de despliegue de EJB no se ejecuta durante la instalación de módulos EJB 3.x.
Esta opción se ignora cuando el EAR o módulo que debe instalarse o actualizarse contiene un descriptor de despliegue de aplicaciones Java Platform, Enterprise Edition (Java EE) 7, un descriptor de despliegue de módulos EJB 3.2 o un descriptor de despliegue de módulos Web 3.1.
Si vuelve a desplegar el archivo EAR (Application Enterprise Archive) con la utilidad EJBDeploy, el valor predeterminado es nodeployejb. Si no es así, toma el valor predeterminado deployejb.
- El archivo EAR se ha ensamblado utilizando una herramienta de ensamblaje, como Rational Application Developer y la herramienta EJBDeploy no se ha ejecutado durante el ensamblaje.
- El archivo EAR no se ha ensamblado utilizando una herramienta de ensamblaje, como Rational Application Developer.
- El archivo EAR se ha ensamblado utilizando las versiones de Application Assembly Tool (AAT) anteriores a la versión 5.0.
Si un módulo EJB está empaquetado en un archivador web (WAR), no es necesario que utilice esta opción deployejb.
Para esta opción, instálelos sólo en un destino de despliegue Versión 9.0.
deployejb.classpath
La opción deployejb.classpath especifica una vía de acceso de clases extra para la herramienta EJBDeploy.
deployejb.complianceLevel
La opción deployejb.complianceLevel especifica el nivel de conformidad JDK para la herramienta EJBDeploy.
1.4
(default) 5.0 6.0
Para obtener una lista de los niveles de conformidad de JDK soportados actualmente, ejecute el mandato ejbdeploy -?
deployejb.dbschema
La opción deployejb.dbschema especifica el esquema de base de datos para la herramienta EJBDeploy.
deployejb.dbtype
La opción deployejb.dbtype especifica el tipo de base de datos para la herramienta 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
Las bases de datos siguientes dan soporte a SQLJ (Structured Query Language in Java):
DB2UDB_V82, DB2UDB_V81, DB2UDBOS390_V7 y DB2UDBOS390_V8.Para obtener una lista de los tipos de proveedores de bases de datos a los que se da soporte, ejecute ejbdeploy -?
deployejb.dbaccesstype
La opción deployejb.dbaccesstype especifica el tipo de acceso de base de datos para la herramienta EJBDeploy. Los valores válidos son SQLj y JDBC. El valor predeterminado es JDBC.
deployejb.rmic
La opción deployejb.rmic especifica opciones RMIC extra para utilizar para la herramienta EJBDeploy.
deployejb.sqljclasspath
La opción deployejb.sqljclasspath especifica la ubicación de las clases del conversor SQLJ.
deployws
La opción deployws especifica que se desplieguen los servicios web durante la instalación. Esta opción no necesita obligatoriamente un valor.
El valor por omisión es: nodeployws.
deployws.classpath
La opción deployws.classpath especifica la vía de acceso de clases extra que se va a utilizar al desplegar los servicios web.
Para especificar las classpaths de varias entradas, separe las entradas con el mismo separador que se utiliza con la variable de entorno CLASSPATH.
Utilice un punto y coma (;)
para separar las entradas nativas.
Utilice un signo de dos puntos para separar las entradas.
deployws.jardirs
La opción deployws.jardirs especifica los directorios de extensión extra que se van a utilizar al desplegar los servicios web.
distributeApp
La opción distributeApp especifica que el componente de gestión de aplicaciones distribuye los archivos binarios de la aplicación. Esta opción no necesita obligatoriamente un valor. Este es el valor por omisión.
EmbeddedRar
La opción EmbeddedRar enlaza los objetos Java 2 Connector con nombres JNDI. Debe enlazar cada objeto J2C (Java 2 Connector) en la aplicación o el módulo, como las fábricas de conexiones J2C, las especificaciones de activación J2C y los objetos administrativos J2C, con un nombre JNDI. Cada elemento de la opción EmbeddedRar contiene los siguientes pasos: RARModule, uri, j2cid, j2c.name, j2c.jndiName. Puede asignar los siguientes valores a los campos: j2c.name, j2c.jndiName.
Módulo de conector: <nombre módulo rar>
URI: <nombre rar>,META-INF/ra.xml
Identificador de objeto: <identificador del objeto J2C>
Nombre: j2cid
Nombre JNDI: eis/j2cid
Fábrica de conexiones J2C: connectionFactoryInterface
Objeto admin J2C: adminObjectInterface
Especificación de activación J2C: tipo de escucha de mensaje
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Si el ID n es exclusivo en el archivo ra.xml, se añadirá -<number>. Por ejemplo, javax.sql.DataSource-2.
Uso del ejemplo de modalidad de proceso por lotes
$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
La opción enableClientModule especifica que se desplieguen los módulos de cliente. Seleccione esta opción si el archivo a desplegar tiene uno o varios módulos de cliente que desea desplegar. Si selecciona esta opción, instale los módulos de cliente sólo en un destino de despliegue de la versión 8.0 o posterior.
Esta opción no necesita obligatoriamente un valor. El valor predeterminado es noenableClientModule. De forma predeterminada, se pasa por alto la opción enableClientModule durante el despliegue y no se despliegan los módulos de cliente.
EnsureMethodProtectionFor10EJB
La opción EnsureMethodProtectionFor10EJB selecciona las protecciones de método para los métodos no protegidos de enterprise bean 1.x. Especifica que se deje el método sin proteger o asigna un protección que deniega todo acceso. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$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']]])
El último campo de cada entrada de esta tarea especifica el valor de protección. Los valores de protección válidos son: methodProtection.denyAllPermission. También puede dejar el valor en blanco si desea que el método permanezca sin protección.
EnsureMethodProtectionFor20EJB
La opción EnsureMethodProtectionFor20EJB selecciona las protecciones de método para los métodos no protegidos de enterprise bean 2.x. Especifica que se asigne un rol de seguridad al método no protegido, añade el método a la lista de exclusión o marca el método como no seleccionado. Puede asignar varios roles a un método separando sus nombres por coma. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización de los datos existentes.
Uso del ejemplo de modalidad de proceso por lotes
En 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}}}
Utilizando Jacl con coincidencia de patrones:
$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']]])
El último campo de cada entrada de esta tarea especifica el valor de protección. Los valores de protección válidos son: methodProtection.uncheck, methodProtection.exclude o una lista de roles de seguridad que están separados por comas.
filepermission
.*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755
Uso del ejemplo de modalidad de proceso por lotes
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
{-appname MyApp -cell myCell -node myNode -server server1
-filepermission .*\\.jsp=777#.*\\.xml=755}
AdminApp.install("raíz_servidor_aplic/installableApps/DynaCacheEsi.ear",
["-appname", "MyApp", "-cell", "myCell", "-node", "myNode", "-server", "server1",
"-filepermission", ".*\\.jsp=777#.*\\.xml=755"])
installdir (en desuso)

installed.ear.destination
La opción installed.ear.destination especifica el directorio donde se colocarán los binarios de la aplicación.
JSPCompileOptions
- Módulo web: xxx
- URI: xxx
- Vía de acceso de clases JSP: <vía acceso clases jsp>
- Utilizar nombres de paquetes completos: Yes | No
- Nivel de origen JDK: xx
- Inhabilitar compilación de tiempo de ejecución JSP: Yes | No
Para utilizar nombres de paquetes completos e inhabilitar la compilación de tiempo de ejecución JSP, especifique un valor de Yes o No en el idioma específico del entorno local. El producto da soporte a los valores de AppDeploymentOption.Yes y AppDeploymentOption.No, en lugar de a Yes y No. No obstante, se recomienda que especifique Yes o No en el idioma de su entorno local.
Uso del ejemplo de modalidad de proceso por lotes
$AdminApp install raíz_servidor_aplic/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 Sí 15 No}}}
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
['-appname', 'MyApp', '-preCompileJSPs', '-JSPCompileOptions',
[["IVT Application", 'ivt_app.war,WEB-INF/web.xml', 'jspcp',
'Sí', 15, 'No']]])
AdminApp.install('ivtApp.ear', ['-appname', 'MyApp', '-preCompileJSPs',
'-JSPCompileOptions', [['.*', '.*', 'jspcp', 'Yes', 15, 'No']]])
JSPReloadForWebMod
- Módulo web: xxx
- URI: xxx
- Recarga de clase de habilitación de JSP: <Yes | No>
- Intervalo de recarga JSP en segundos: <número interno recarga jsp>
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.
Para recargar la clase de habilitación de JSP, especifique un valor Sí o No en el idioma específico del entorno local. El producto da soporte a los valores de AppDeploymentOption.Yes y AppDeploymentOption.No, en lugar de a Yes y No. No obstante, se recomienda que especifique Yes o No en el idioma de su entorno local.
Uso del ejemplo de modalidad de proceso por lotes
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
{-appname MyApp -JSPReloadForWebMod {{"IVT Application"
ivt_app.war,WEB-INF/web.xml Yes 5}}}
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
{-appname MyApp -JSPReloadForWebMod {{.* .* Yes 5}}}
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
['-appname', 'MyApp', '-JSPReloadForWebMod [["IVT Application"
ivt_app.war,WEB-INF/web.xml Yes 5 ]]'])
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
['-appname', 'MyApp', '-JSPReloadForWebMod', [['.*', '.*', 'Yes', ‘5']]])

No obstante, puede existir un módulo de Java EE 5 o posterior dentro de una aplicación que incluya archivos previos a Java EE 5 y que utilice la extensión de nombre de archivo .xmi.
Los archivos ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, y ibm-portlet-ext.xmi siguen utilizando la extensión de archivo .xmi.
sptcfgMapEJBRefToEJB
La opción MapEJBRefToEJB correlaciona las referencias Java de enterprise con enterprise beans. Debe establecer la correlación de cada referencia de enterprise bean de la aplicación con un enterprise bean. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
Si la referencia de EJB procede de un módulo EJB 3.x, Web 2.4 o Web 2.5, el nombre JNDI es opcional. Si especifica la opción useAutoLink, el nombre JNDI es opcional. El entorno de ejecución proporciona un contenedor predeterminado. Un módulo EJB 3.0 o posterior no puede contener beans de entidad de persistencia gestionada por bean o gestionada por contenedor. La instalación falla si un bean de entidad de persistencia gestionada por bean o gestionada por contenedor se empaqueta en un módulo EJB 3.x de una aplicación Java EE. Sólo puede empaquetar los beans de persistencia gestionada por bean o gestionada por contenedor en un módulo EJB 2.1 o anterior.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Sólo tiene que proporcionar datos para las filas o entradas a las que les falte información, o aquéllas en las que desee actualizar los datos existentes.
Uso del ejemplo de modalidad de proceso por lotes
En 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}}}
Utilizando Jacl con coincidencia de patrones:
![[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]]]')
Utilizando Jython con coincidencia de patrones:
![[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
La opción MapEnvEntryForApp edita el valor env-entry de la aplicación. Puede utilizar esta opción para editar el valor env-entry en el archivo application.xml .
- Nombre: xxx
- Tipo: xxx
- Descripción: xxx
Avoid trouble: Si después de ejecutar los enlaces predeterminados, el valor es un valor null, debe cambiar el valor por . * antes de ejecutar esta tarea. El valor .* es el valor de comodín, que permite que coincida cualquier descripción. Si deja el valor como null, las excepciones se producirán cuando ejecute la tarea MapEnvEntryForApp.gotcha
- Valor: <valor env-entry>
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.
Uso del ejemplo de modalidad de proceso por lotes
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
{-appname MyApp -MapEnvEntryForApp {{MyApp/appEnvEntry String null newEnvEntry}}}
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
{-appname MyApp2 -MapEnvEntryForApp {{.* .* .* newEnvEntry}}}
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
['-appname', 'MyApp3', '-MapEnvEntryForApp', [['MyApp/appEnvEntry', 'String', 'null', 'newEnvEntry']]])
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
['-appname', 'MyApp4', '-MapEnvEntryForApp', [['.*', '.*', '.*', 'newEnvEntry']]])
Si hay un nuevo carácter de línea en la descripción, utilice la sintaxis siguiente:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
{-appname MyApp5 -MapEnvEntryForApp {{.* .* (?s).* newEnvEntry}}}
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
['-appname', 'MyApp6', '-MapEnvEntryForApp',
[['.*', '.*', '(?s).*', 'newEnvEntry']]])
MapEnvEntryForClientMod
La opción MapEnvEntryForClientMod edita el valor env-entry del módulo de cliente. Puede utilizar esta opción para editar el valor de las entradas de entorno del módulo de cliente, archivo application-client.xml.
- módulo de cliente: xxx
- URI: xxx
- Nombre: xxx
- Tipo: xxx
- Descripción: xxx
- Valor: <valor env-entry>
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para el módulo de cliente.
Uso del ejemplo de modalidad de proceso por lotes
$AdminApp install raíz_servidor_aplicaciones/installableApps/myapp.ear
{-appname MyApp -MapEnvEntryForClientMod {{"Módulo de cliente" 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', [["Módulo de cliente",
'client.jar,META-INF/application-client.xml', 'clientObject',
'String', 'null', 'newValue']]])
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
[['.*', '.*', '.*', '.*', '.*', 'newValue']]])
Si hay un nuevo carácter de línea en la descripción, utilice la sintaxis siguiente:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.* .* .*
(?s).* newValue}}}
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
[['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])
MapEnvEntryForEJBMod
La opción MapEnvEntryForEJBMod edita el valor env-entry del módulo EJB. Puede utilizar esta opción para editar el valor de las entradas de entorno en el módulo EJB, ejb-jar.xml.
- Módulo: xxx
- URI: xxx
- Bean: xxx
- Nombre: xxx
- Tipo: xxx
- Descripción: xxx
Avoid trouble: Si después de ejecutar los enlaces predeterminados, el valor es un valor null, debe cambiar el valor por . * antes de ejecutar esta tarea. El valor .* es el valor de comodín, que permite que coincida cualquier descripción. Si deja el valor en null, se producirán excepciones WASX7017E y WASX7111E cuando ejecute la tarea MapEnvEntryForEJBMod. gotcha
- Valor: <valor env-entry>
Si el módulo EJB utiliza EJB 3.0 o posterior, el contenido de esta opción sólo se llena a partir del descriptor de despliegue XML. Con esta opción, no se puede obtener la información de despliegue a partir de las anotaciones.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.
Uso del ejemplo de modalidad de proceso por lotes
$AdminApp install raíz_servidor_aplic/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('raíz_servidor_aplic/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 hay un nuevo carácter de línea en la descripción, utilice la sintaxis siguiente:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForEJBMod {{.* .* .*
(?s).* newValue}}}
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
[['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])
MapEnvEntryForWebMod
La opción MapEnvEntryForWebMod edita el valor env-entry del módulo web. Puede utilizar esta opción para editar el valor env-entry en el archivo web.xml.
- Módulo web: xxx
- URI: xxx
- Nombre: xxx
- Tipo: xxx
- Descripción: xxx
Avoid trouble: Si, después de ejecutar los enlaces por omisión, el valor es null, debe cambiar el valor a .* para poder ejecutar esta tarea. El valor .* es el valor de comodín, que permite que coincida cualquier descripción. Si deja el valor en null, se producirán excepciones WASX7017E y WASX7111E cuando ejecute la tarea MapEnvEntryForWebMod. gotcha
- Valor: <valor env-entry>
Si el módulo web utiliza un Servlet 2.5, el contenido de esta opción sólo se llena a partir del descriptor de despliegue XML. Con esta opción, no se puede obtener la información de despliegue a partir de las anotaciones.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.
Uso del ejemplo de modalidad de proceso por lotes
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
{-appname MyApp -MapEnvEntryForWebMod {{"IVT Application" ivt_app.war,
WEB-INF/web.xml ivt/ivtEJBObject String null newEnvEntry}}}
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
{-appname MyApp2 -MapEnvEntryForWebMod {{.* .* .* .* newEnvEntry}}}
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
['-appname', 'MyApp3', '-MapEnvEntryForWebMod', [["IVT Application",
'ivt_app.war,WEB-INF/web.xml', 'ivt/ivtEJBObject', 'String', 'null', 'newEnvEntry']]])
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
['-appname', 'MyApp4', '-MapEnvEntryForWebMod', [['.*', '.*', '.*', '.*', 'newEnvEntry']]])
Si hay un nuevo carácter de línea en la descripción, utilice la sintaxis siguiente:
$AdminApp install raíz_servidor_aplic/installableApps/ivtApp.ear
{-appname MyApp5 -MapEnvEntryForWebMod {{.* .* .* (?s).* newEnvEntry}}}
AdminApp.install('raíz_servidor_aplic/installableApps/ivtApp.ear',
['-appname', 'MyApp6', '-MapEnvEntryForWebMod',
[['.*', '.*', '.*', '(?s).*', 'newEnvEntry']]])
MapInitParamForServlet
- Módulo web: xxx
- URI: xxx
- Servlet: xxx
- Nombre: xxx
- Descripción: null
- Valor: <valor parámetro inicial>
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.
Uso del ejemplo de modalidad de proceso por lotes
$AdminApp install raíz_servidor_aplic/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('raíz_servidor_aplic/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
- Módulo: xxx
- URI: xxx
- Utilice JASPI: Sí | No | Heredar
- Nombre de proveedor de JASPI: xxx
Para utilizar JASPI, especifique un valor Sí, No o Heredar en el idioma específico del entorno local.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$AdminApp install myapp.ear {-MapJaspiProvider {{myapp META-INF/application.xml Yes Provider1} }}
AdminApp.install('myapp.ear', '[-appname myapp
-MapJaspiProvider [[myapp META-INF/application.xml Sí Provider1] ]]')
MapMessageDestinationRefToEJB
La opción MapMessageDestinationRefToEJB correlaciona las referencia de destino de mensajes con los nombres JNDI (Java Naming and Directory Interface) de los objetos administrativos de los adaptadores de recursos instalados. Debe establecer la correlación de cada referencia de destino de mensajes de la aplicación con un objeto administrativo. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
- Módulo: ejb-jar-ic.jar
- Bean: MessageBean
- URI: ejb-jar-ic.jar,META-INF/ejb-jar.xml
- Objeto de destino de mensaje: jms/GSShippingQueue
- Nombre JNDI de recurso de destino: [jms/GSShippingQueue]:
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$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
La opción MapModulesToServers especifica el servidor de aplicaciones donde desea instalar los módulos incluidos en la aplicación. Puede instalar módulos en el mismo servidor o dispersarlos entre varios servidores. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
En el ejemplo siguiente se instala Increment.jar en un servidor:
$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] ]]')
En el ejemplo siguiente se instala Increment.jar y se correlaciona con dos servidores gestionados por un gestor de despliegue:
$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]]]')
En el ejemplo siguiente se añade server2 y server3 a una aplicación que está instalada:
$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'])
En el siguiente ejemplo se elimina server1 de la aplicación que está instalada:
$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
La opción MapResEnvRefToRes correlaciona las referencias de entorno de recursos con los recursos. Debe establecer la correlación de cada referencia de entorno de recursos definida en la aplicación con un recursos. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$AdminApp install raíz_servidor_aplic/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 raíz_servidor_aplic/installableApps/sibwsjmsepl.ear {
-MapResEnvRefToRes {{.* .* .* .* .* jndi1}}}
AdminApp.install('raíz_servidor_aplic/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
La opción MapResRefToEJB correlaciona las referencias de recursos con los recursos. Debe establecer la correlación de cada referencia de recursos definida en la aplicación con un recurso. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
- Módulo: Ejb1
- Bean: MailEJBObject
- URI: deplmtest.jar,META-INF/ejb-jar.xml
- Referencia de recurso: jms/MyConnectionFactory
- Tipo de recurso: javax.jms.ConnectionFactory
- Nombre JNDI de recurso de destino: [jms/MyConnectionFactory]:
- Nombre de configuración de inicio de sesión: [null]: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
- Propiedades: []: Utilice esta opción para crear una configuración de inicio de sesión personalizada. El cliente puede utilizar JAAS para crear un diseño de inicio de sesión.
- Propiedades del origen de datos ampliado: []: Utilice esta opción para que un origen de datos que emplee la agrupación heterogénea pueda conectarse a una base de datos DB2. El patrón para la propiedad es property1=value1+property2=value 2.
La configuración de inicio de sesión DefaultPrincipalMapping la utilizan los conectores J2C (Java 2 Connectors) para correlacionar los usuarios con los principales definidos en las entradas de datos de autenticación J2C. Si login.config.name se establece en DefaultPrincipalMapping, se crea una propiedad con el nombre com.ibm.mapping.authDataAlias. El valor de la propiedad lo establece auth.props. Si login.config.name no se establece en DefaultPrincipalMapping, auth.props puede especificar varias propiedades. El formato de la serie es websphere:name= <name1>,value=<value1>,description=<desc1>. Para especificar varias propiedades utilice el signo más (+).
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$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\"
En la sustitución de mandatos, refiérase a la variable tal como se muestra en el ejemplo siguiente:"clientApplicationInformation=value1,value2" with "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
La opción MapRolesToUsers correlaciona usuarios con roles. Debe establecer la correlación de cada rol definido en la aplicación o el módulo con un usuario de grupo del registro de usuarios de dominio. Puede especificar varios usuarios o grupos para un solo rol separándolos por un símbolo |. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$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]]]')
donde {{"All Role" No Yes "" ""} corresponde a lo siguiente:
Opción | Descripción |
---|---|
"All Role" | Representa el nombre del rol |
No | Indica que se permite el acceso a todos (sí/no) |
Yes | Indica que se permite el acceso a todos los usuarios sin autenticar (sí/no) |
"" | Indica los usuarios correlacionados |
"" | Indica los grupos correlacionados |
"Todos los autenticados en reinos de confianza" | Indica que se puede otorgar acceso a cualquier usuario vario del reino. |
"ID de acceso de usuarios correlacionados" | Indica los ID de acceso de usuarios correlacionados |
"ID de acceso de grupos correlacionados" | Indica los ID de acceso de grupos correlacionados |
MapRunAsRolesToUsers
La opción establece la correlación de roles RunAs con usuarios. Los enterprise beans que instala contienen roles RunAs predefinidos. Los enterprise beans que deben ejecutarse como un rol determinado que debe reconocerse al interactuar con otro enterprise bean utilizan roles RunAs. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
En 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}}}
Utilizando 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
- Módulo: xxx
- URI: META-INF/application.xml
- Bibliotecas compartidas: <biblioteca compartida>
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.
Uso del ejemplo de modalidad de proceso por lotes
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
{-appname DynaCacheEsi -MapSharedLibForMod {{ DynaCacheEsi META-INF/application.xml
sharedlib1 }{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 }}}
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
{-appname DynaCacheEsi -MapSharedLibForMod {{ .* .* sharedlib1 }
{ .* .* sharedlib2 }}}
AdminApp.install('raíz_servidor_aplic/installableApps/DynaCacheEsi.ear',
'[ -MapSharedLibForMod [[ DynaCacheEsi META-INF/application.xml sharedlib1 ]
[ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 ]]]' )
AdminApp.install('raíz_servidor_aplic/installableApps/DynaCacheEsi.ear',
'[ -MapSharedLibForMod [[ .* .* sharedlib1 ][ .* .* sharedlib2 ]]]' )
MapWebModToVH
La opción MapWebModToVH selecciona los hosts virtuales para los módulos web. Especifique el host virtual donde desea instalar los módulos web contenidos en la aplicación. Puede instalar módulos web en el mismo host virtual o dispersados entre varios hosts. Utilice esta opción para proporcionar los datos que faltan o actualizar una tarea.
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación. Es necesario proporcionar datos para filas o entradas a las que les falte información o que requieren una actualización.
Uso del ejemplo de modalidad de proceso por lotes
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
{-appname DynaCacheEsi
-MapWebModToVH {{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host }}}
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
{-MapWebModToVH {{ .* .* default_host }}}
AdminApp.install('raíz_servidor_aplic/installableApps/DynaCacheEsi.ear',
'[-MapWebModToVH [[ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host ]]]')
AdminApp.install('raíz_servidor_aplic/installableApps/DynaCacheEsi.ear',
['-MapWebModToVH', [['.*', '.*', 'default_host']]])
MetadataCompleteForModules
La opción MetadataCompleteForModules permite a cada módulo Java EE o posterior 2.5 escribir el descriptor de despliegue completo, incluida la información de despliegue de las anotaciones. A continuación, el sistema marca como completo el descriptor de despliegue para el módulo.

- Módulo: EJBDD_1.jar
- URI: EJBDD_1.jar,META-INF/ejb-jar.xml
- Descriptor de despliegue de bloqueo: [false]:
- Módulo: EJBNoDD_2.jar
- URI: EJBNoDD_2.jar,META-INF/ejb-jar.xml
- Descriptor de despliegue de bloqueo: [false]:
Utilice el mandato taskInfo del objeto AdminApp para obtener información sobre los datos necesarios para la aplicación.
Uso del ejemplo de modalidad de proceso por lotes
En 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}}}
Utilizando Jacl con coincidencia de patrones:
![[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}}}
Utilizando 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']]])
Utilizando Jython con coincidencia de patrones:
![[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
La opción ModuleBuildID muestra el identificador de compilación de un módulo en un archivo EAR de la aplicación. Esta opción no se puede modificar porque es de solo lectura. Esta opción devuelve la información de compilación para un módulo si ha especificado el identificador de compilación en el archivo MANIFEST.MF de un módulo o archivo EAR de aplicación. La información de compilación consiste en el nombre del módulo, el URI del módulo y el identificador de compilación.
- Módulo: CacheClient
- URI: CacheClient.jar,META-INF/application-client.xml
- ID de compilación: alpha
- Módulo: MailConnector
- URI: Mail.rar,META-INF/ra.xml
- ID de compilación: abc
- Módulo: CacheWeb1
- URI: CacheWeb1.war,WEB-INF/web.xml
- ID de compilación: alpha
- Módulo: JspWeb1
- URI: JspWeb1.war,WEB-INF/web.xml
- ID de compilación: v1.0
- Módulo: Servlet
- URI: Servlet.war,WEB-INF/web.xml
- ID de compilación: 0.5
Uso del ejemplo de modalidad de proceso por lotes
En 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
La opción noallowDispatchRemoteInclude no permite a la aplicación de empresa que asigne solicitudes includes a recursos a través de los módulos web en distintas máquinas virtuales Java en un entorno de nodo gestionado a través del mecanismo del asignador de solicitudes estándar.
noallowPermInFilterPolicy
La opción noallowPermInFilterPolicy especifica que no se continúe con el proceso de despliegue de aplicaciones si la aplicación contiene permisos de política que están en la política de filtros. Esta opción es el valor predeterminado y no necesita ningún valor.
noallowServiceRemoteInclude
La opción noallowServiceRemoteInclude no permite a la aplicación de empresa prestar servicios a una solicitud include procedente de una aplicación de empresa que tenga la opción allowDispatchRemoteInclude establecida en true.
node
La opción node especifica el nombre de nodo para instalar o actualizar toda una aplicación o para actualizar una aplicación con objeto de añadir un módulo nuevo. Si desea actualizar toda una aplicación, esta opción sólo se aplica si la aplicación contiene un nuevo módulo que no existe en la aplicación instalada.
Uso del ejemplo de modalidad de proceso por lotes
En 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}
Utilizando 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
La opción nocreateMBeansForResources especifica que no se crean MBeans para todos los recursos como, por ejemplo, servlets, archivos JSP (JavaServer Pages) y enterprise beans, que se definen en una aplicación cuando se inicia la aplicación en un destino de despliegue. Esta opción es el valor predeterminado y no necesita ningún valor.
nodeployejb
La opción nodeployejb especifica que no se ejecute la herramienta EJBDeploy durante la instalación. Esta opción es el valor predeterminado y no necesita ningún valor.
nodeployws
La opción nodeployws especifica que no se desplieguen los servicios web durante la instalación. Esta opción es el valor predeterminado y no necesita ningún valor.
nodistributeApp
La opción nodistributeApp especifica que el componente de gestión de aplicaciones no distribuya los binarios de la aplicación. Esta opción no necesita obligatoriamente un valor. El valor predeterminado es la opción distributeApp.
noenableClientModule
La opción noenableClientModule especifica que no se desplieguen módulos de cliente. Esta opción no necesita obligatoriamente un valor. Es el valor predeterminado. El valor predeterminado no va a desplegar módulos de cliente. Utilice la opción enableClientModule para desplegar módulos de cliente.
noreloadEnabled
La opción noreloadEnabled inhabilita la recarga de clases. Esta opción es el valor predeterminado y no necesita ningún valor. Para especificar que el sistema de archivos de la aplicación se explorará en busca de archivos actualizados para que los cambios se recarguen de forma dinámica, utilice la opción reloadEnabled.
nopreCompileJSPs
La opción nopreCompileJSPs especifica que no se precompilen los archivos JavaServer Pages. Esta opción es el valor predeterminado y no necesita ningún valor.
noprocessEmbeddedConfig
La opción noprocessEmbeddedConfig especifica que el sistema debe ignorar los datos de configuración incorporados incluidos en la aplicación. Esta opción no necesita obligatoriamente un valor. Si el archivo EAR (enterprise archive) de la aplicación no contiene datos de configuración incorporados, la opción noprocessEmbeddedConfig es el valor predeterminado. De lo contrario, el valor predeterminado es la opción processEmbeddedConfig.
nouseAutoLink
La opción nouseAutoLink especifica que no se utilice la opción useAutoLink y que no se resuelvan automáticamente las referencias de EJB (Enterprise JavaBeans) de las versiones del módulo EJB anteriores a EJB 3.0 y de las versiones del módulo web anteriores a la versión 2.4.
nouseMetaDataFromBinary
La opción nouseMetaDataFromBinary especifica que los metadatos que se utilizan en el tiempo de ejecución, por ejemplo, los descriptores de despliegue, los enlaces, las extensiones, etc. vienen del repositorio de configuración. Esta opción es el valor predeterminado y no necesita ningún valor. Utilice esta opción para indicar que los metadatos utilizados en tiempo de ejecución provienen del archivo EAR (enterprise archive).
nousedefaultbindings
La opción nousedefaultbindings especifica no utilizar los enlaces predeterminados para la instalación. Esta opción es el valor predeterminado y no necesita ningún valor.
novalidateSchema
La opción novalidateSchema especifica que no se validen los descriptores de despliegue contra los esquemas de descriptor de despliegue Java EE publicados. Esta opción no necesita obligatoriamente un valor. Es el valor predeterminado. El valor predeterminado es no validar descriptores de despliegue.
operación
- add: añade nuevo contenido.
- addupdate: añade o actualiza el contenido basándose en la existencia de contenido en la aplicación.
- delete: suprime contenido.
- update: actualiza el contenido existente.
La opción operation es necesaria si el tipo de contenido es file o modulefile. Si el valor del tipo de contenido es app, el valor de la opción operation debe ser update. La opción contenturi se pasa por alto si el tipo de contenido es app.
Uso del ejemplo de modalidad de proceso por lotes
En los siguientes ejemplos se muestra cómo utilizar las opciones del mandato update para actualizar toda la aplicación empresarial desplegada:
$AdminApp update "IVT Application" app {-operation update
-contents raíz_servidor_aplic/installableApps/ivtApp.ear}
AdminApp.update('IVT Application', 'app', '[ -operation update
-contents raíz_servidor_aplic/installableApps/ivtApp.ear ]' )
En los siguientes ejemplos se muestra cómo utilizar las opciones del mandato update para actualizar un solo archivo en una aplicación desplegada:
En 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}
Utilizando la serie 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]')
Utilizando la lista 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'])
donde AdminApp es el objeto de script, update es el mandato, app1 es el nombre de la aplicación que desea actualizar, file es el tipo de contenido, operation es una opción del mandato update, update es el valor de la opción operation, contents es una opción del mandato update, /apps/app1/my.xml es el valor de la opción contents, contenturi es una opción del mandato update y app1.jar/my.xml es el valor de la opción contenturi.
processEmbeddedConfig
La opción processEmbeddedConfig procesa los datos de la configuración incorporados que se incluyen en la aplicación. Esta opción no necesita obligatoriamente un valor. Si el archivo EAR (enterprise archive) de la aplicación contiene datos de configuración incorporados, esta opción es el valor predeterminado. Si no es así, el valor predeterminado es la opción nonprocessEmbeddedConfig.
Este valor afecta a la instalación de archivos EAR ampliados. Un archivo EAR ampliado se produce cuando exporta una aplicación instalada. Los archivos EAR ampliados tienen una configuración incorporada que consta de archivos como resource.xml y variables.xml. Esta opción carga una configuración incorporada en el ámbito de aplicación desde el archivo EAR.
Si ha exportado la aplicación de una célula diferente a la célula actual y no ha especificado la variable $(CELL) para la opción installed.ear.destination cuando instaló por primera vez la aplicación, utilice la opción nonprocessEmbeddedConfig para expandir el archivo EAR ampliado en el directorio raíz_perfil/installedApps/nombre_célula_actual. De lo contrario, utilice la opción processEmbeddedConfig para expandir el archivo EAR ampliado en el directorio raíz_perfil/installedApps/nombre_célula_original, donde nombre_célula_original es la célula en la que se instaló por primera vez la aplicación. Si especificó la variable $(CELL) para la opción installed.ear.destination cuando instaló por primera vez la aplicación, la instalación expandirá el archivo EAR ampliado en el directorio raíz_perfil/installedApps/nombre_célula_actual.
preCompileJSPs
La opción preCompileJSPs especifica que se deben precompilar los archivos JavaServer Pages. Esta opción no necesita obligatoriamente un valor. El valor predeterminado es nopreCompileJSPs. Si desea precompilar archivos JavaServer Pages, especifíquelo como parte de la instalación. El valor predeterminado es no precompilar archivos JSP (JavaServer Pages). La opción preCompileJSPs se ignora durante el despliegue y los archivos JSP (JavaServer Pages) no se precompilan. El distintivo se establece automáticamente con las herramientas de ensamblaje.
reloadEnabled
La opción reloadEnabled especifica que el sistema de archivos de la aplicación se explorará para los archivos actualizados para que los cambios se recarguen de forma dinámica. Si la opción está habilitada y se modifican las clases de la aplicación, entonces la aplicación se detiene y se reinicia para volver a cargar las clases actualizadas. Esta opción no es el valor predeterminado y no necesita ningún valor. El valor predeterminado es la opción noreloadEnabled.
reloadInterval
La opción reloadInterval especifica el periodo de tiempo en segundos durante los cuales el sistema de archivos de la aplicación se explorarán para los archivos actualizados. El intervalo válido es mayor que cero. El valor predeterminado es tres segundos.
SharedLibRelationship
La opción SharedLibRelationship asigna activos o ID de unidad de composición como bibliotecas compartidas para cada módulo Java EE.
- Módulo: EJB3BNDBean.jar
- URI: EJB3BNDBean.jar,META-INF/ejb-jar.xml
- ID de relación: especifique activos o ID de unidad de composición, como [WebSphere:cuname=sharedLibCU1,cuedition=1.0] o WebSphere:assetname=sharedLibAsset1.jar
- Nombres de unidad de composición: especifique opcionalmente nombres de unidad de composición para los ID de relación de activos. El sistema utiliza el mismo nombre que el activo si no especifica un nombre de unidad de composición. []
- Destino de coincidencia: [Yes]:
- Si especifica un activo, el sistema crea una unidad de composición con dicho activo en la misma aplicación de nivel de negocio a la que pertenece la aplicación Java EE.
- Si especifica un valor para los nombres de unidad de composición, la posición del sistema hace coincidir cada nombre con los valores de los ID de relación correspondientes.
- Si el ID de relación es un ID de unidad de composición, el sistema ignora el nombre de unidad de composición correspondiente.
- Si el ID de relación es un ID de activo, el sistema crea la unidad de composición con el nombre de unidad de composición correspondiente.
Para especificar más de un activo o ID de unidad de composición, separe cada valor con el carácter de signo más (+).
Al utilizar el mandato edit para la aplicación Java EE, puede alterar temporalmente la relación con un nuevo conjunto de ID de relación de unidad de composición, o bien puede añadir o eliminar relaciones de unidad de composición existentes. No puede especificar una relación de activo si se utiliza el mandato edit. Especifique el primer carácter del ID de unidad de composición como el carácter de signo más (+) para añadirlo a la relación, o bien especifique el carácter de signo más (#) para eliminar el ID de unidad de composición de las relaciones existentes. Por ejemplo, la sintaxis de la unidad de composición +cuname=cu2.zip añade la unidad de composición cu2 a la relación. La sintaxis de la unidad de composición #cuname=cu1.zip+cuname=cu2.zip elimina las unidades de composición cu1 y cu2 de la relación.
Uso del ejemplo de modalidad de proceso por lotes
En Jacl:
$AdminApp install myapp.ear {-SharedLibRelationship {{EJB3BNDBean.jar
EJB3BNDBean.jar,META-INF/ejb-jar.xml WebSphere:cuname=sharedLibCU1 "" Yes}}}
Utilizando Jacl con coincidencia de patrones:
$AdminApp install myapp.ear {-SharedLibRelationship {{.*
EJB3BNDBean.jar,.* WebSphere:cuname=sharedLibCU1 "" Yes}}}
Utilizando Jython:
AdminApp.install('myapp.ear', ['-SharedLibRelationship',
[['EJB3BNDBean,jar', 'EJB3BNDBean.jar,META-INF/ejb-jar.xml',
'WebSphere:cuname=sharedLibCU1,' '', 'Yes']]])
Utilizando Jython con coincidencia de patrones:
AdminApp.install('myapp.ear', ['-SharedLibRelationship', [['.*',
'EJB3BNDBean.jar,.*', 'WebSphere:cuname=sharedLibCU1', '', 'Yes']]]
servidor
- Instalar una aplicación nueva.
- Sustituir una aplicación existente por una versión actualizada de dicha aplicación. En este caso, la opción server es significativa sólo si la versión actualizada de la aplicación contiene un módulo nuevo que no existe en la versión ya instalada de la aplicación.
- Añadir un módulo nuevo a una aplicación existente.
Las opciones -cluster y -server no se pueden utilizar juntas. Si desea desplegar una aplicación y especificar el servidor HTTP durante el despliegue para que la aplicación aparezca en el archivo plugin-cfg.xml generado, en primer lugar, debe instalar la aplicación con un destino de -cluster. Después de instalar la aplicación y antes de guardar, utilice el mandato edit del objeto AdminApp para añadir la correlación adicional con el servidor web.
Uso del ejemplo de modalidad de proceso por lotes
En Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
{-server server1}
Utilizando Jython:
AdminApp.install('raíz_servidor_aplic/installableApps/DynaCacheEsi.ear',
'[-server server1]')
target
La opción target especifica el destino para las funciones de instalación del objeto AdminApp. Este es un ejemplo de una opción de destino: WebSphere:cell=mycell,node=mynode,server=myserver
Uso del ejemplo de modalidad de proceso por lotes
En el siguiente ejemplo se especifica server1 como el servidor de destino para la instalación de la aplicación:
En Jacl:
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
{-appname MyApp -target WebSphere:cell=myCell,node=myNode,server=server1}
En Jython:
AdminApp.install("raíz_servidor_aplic/installableApps/DynaCacheEsi.ear",
["-appname", "MyApp", "-target", "WebSphere:cell=myCell,node=myNode,server=server1"])
En el siguiente ejemplo se especifican server1 y server2 como los servidores de destino para la instalación de la aplicación:
$AdminApp install raíz_servidor_aplic/installableApps/DynaCacheEsi.ear
{-appname MyApp -target
WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2}
AdminApp.install("raíz_servidor_aplic/installableApps/DynaCacheEsi.ear",
["-appname", "MyApp", "-target",
"WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2"])
En el siguiente ejemplo se elimina server3 de la aplicación que está instalada:
$AdminApp install
raíz_servidor_aplic/binaries/DefaultApplication.ear {-appname MyApp
-target -WebSphere:cell=GooddogCell,node=BaddogNode,server=server3
-update -update.ignore.old}
AdminApp.install("raíz_servidor_aplic/binaries/DefaultApplication.ear",
["-appname", "MyApp",
"-target", "-WebSphere:cell=GooddogCell,node=BaddogNode,server=server3",
"-update", "-update.ignore.old"])
En el siguiente ejemplo se añade server4 a la aplicación que está instalada:
$AdminApp update app {-appname MyApp
-target +WebSphere:cell=GooddogCell,node=GooddogNode,server=server4
-contents raíz_servidor_aplic/binaries/DefaultApplication.ear
-operation update -update.ignore.old}
AdminApp.update("app", ["-appname", "MyApp",
"-target", "+WebSphere:cell=GooddogCell,node=GooddogNode,server=server4",
"-contents", "raíz_servidor_aplic/binaries/DefaultApplication.ear",
"-operation", "update", "-update.ignore.old"])
update
La opción update actualiza la aplicación instalada con una versión nueva del archivo EAR (Enterprise Archive). Esta opción no necesita obligatoriamente un valor.
La aplicación para actualizar, que se especifica mediante la opción appname, ya debe estar instalada en la configuración de WebSphere Application Server. La acción de actualización fusiona los enlaces de la versión nueva con los de la versión anterior, desinstala la versión anterior e instala la nueva. La información de enlaces de la versión nueva del archivo EAR o del módulo tiene preferencia sobre la información correspondiente de la versión anterior. Si en la versión nueva falta algún elemento de enlace, se utilizará el elemento correspondiente de la versión anterior.
update.ignore.new
La opción update.ignore.new especifica que durante la acción de actualización, se da preferencia a la información de enlaces de la versión anterior de la aplicación o módulo por encima de la información de enlaces correspondiente de la nueva versión. Si algún elemento de la información de enlace no existe en la versión anterior, se utiliza el elemento de la versión nueva. Es decir, los enlaces de la versión nueva de la aplicación o módulo se ignoran si ya existe un enlace en la versión anterior. De lo contrario, los nuevos enlaces se aceptan y no se ignoran. Esta opción no necesita obligatoriamente un valor.
- La opción update para el mandato install.
- Modulefile o app como tipo de contenido para el mandato update.
update.ignore.old
- La opción update para el mandato install.
- Modulefile o app como tipo de contenido para el mandato update.
useAutoLink
Utilice la opción useAutoLink para resolver automáticamente las referencias de EJB (Enterprise JavaBeans) de las versiones de módulo EJB anteriores a EJB 3.0, y de las versiones del módulo web anteriores a la versión 2.4. Si habilita la opción useAutoLink, puede especificar opcionalmente el nombre JNDI para la opción MapEJBRefToEJB. Cada módulo de la aplicación debe compartir un destino común para habilitar el soporte de enlace automático.
Uso del ejemplo de modalidad de proceso por lotes
En 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}
Utilizando 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
La opción usedefaultbindings especifica que se deben utilizar los enlaces para la instalación. Esta opción no necesita obligatoriamente un valor. El valor predeterminado es nousedefaultbindings.
Para utilizar el puerto de escucha existente en lugar de utilizar o crear una nueva especificación de activación, determine si la versión JAR de EJB es anterior a la 2.1. El sistema crea y utiliza automáticamente una especificación de activación si especifica la opción -usedefaultbindings para desplegar una aplicación. Si existe una especificación de activación, el sistema ignora el puerto de escucha y, en su lugar, utiliza la especificación de activación. Para desplegar una aplicación con una versión JAR de EJB mayor o igual a 2.1 con los puertos de escucha definidos en lugar de una nueva especificación de activación, establezca la propiedad del sistema com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting en true en el archivo wsadmin.properties del directorio de propiedades del perfil de interés.
useMetaDataFromBinary
La opción useMetaDataFromBinary especifica que los metadatos que se utilizan en el tiempo de ejecución, por ejemplo, descriptores de despliegue, enlaces, extensiones, etc. proceden del archivo EAR. Esta opción no necesita obligatoriamente un valor. El valor predeterminado nouseMetaDataFromBinary que significa que los metadatos utilizados en tiempo de ejecución vienen del repositorio de configuración.
validateinstall
- off: especifica que no se realiza la validación del despliegue de la aplicación. Este valor es el predeterminado.
- warn: realiza la validación del despliegue de la aplicación y sigue con el proceso de despliegue de la aplicación aunque existan avisos o mensajes notificados.
- fail: realiza la validación de despliegue de la aplicación y no sigue con el proceso de despliegue de la aplicación cuando existan avisos o mensajes de error notificados.
validateSchema
La opción validateSchema especifica que se validen los descriptores de despliegue con los esquemas de descriptor de despliegue Java EE publicados. Cuando esta opción de despliegue de aplicaciones está seleccionada, el producto analiza cada descriptor de despliegue para determinar la versión de la especificación Java EE para el descriptor de despliegue, selecciona el esquema adecuado y, a continuación, comprueba el descriptor de despliegue en el esquema de descriptor de despliegue de Java EE. Los errores de validación producen mensajes de error.
Esta opción no necesita obligatoriamente un valor. El valor predeterminado es novalidateSchema. De forma predeterminada, la opción validateSchema se pasa por alto durante el despliegue y el producto no valida los descriptores de despliegue.
verbose
La opción verbose produce que se visualicen mensajes adicionales durante la instalación. Esta opción no necesita obligatoriamente un valor.
WebServicesClientBindDeployedWSDL
La opción WebServicesClientBindDeployedWSDL identifica el servicio web cliente que está modificando. Los campos de ámbito son: Módulo, EJB y Servicio web. El único valor modificable de esta tarea es el nombre de archivo de WSDL. Indica el WSDL (Web Services Description Language) que utiliza el cliente.
El campo Módulo identifica la aplicación web o empresarial dentro de la aplicación. Si el módulo es un enterprise bean, el campo EJB identifica un determinado enterprise bean dentro del módulo. El campo Servicio web identifica el servicio web dentro del módulo de enterprise bean o de aplicación web. Este identificador se corresponde con el atributo wsdl:service del archivo WSDL, que tiene un prefijo de service/; por ejemplo, service/WSLoggerService2.
El atributo WSDL desplegado denomina a un archivo WSDL relativo al módulo de cliente. Este es un ejemplo de un WSDL desplegado para una aplicación web: WEB-wsloggerservice.
Uso del ejemplo de modalidad de proceso por lotes
$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 {{ "nombre_módulo" servicios_web.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 [[ "nombre_módulo" servicios_web.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
La opción WebServicesClientBindPortInfo identifica el puerto de un servicio web cliente que se está modificando. Los campos de ámbito son: Módulo, EJB, Servicio web y Puerto. Los valores modificables de esta tarea son: Tiempo de espera de sincronización, ID de BasicAuth, Contraseña de BasicAuth, Configuración SSL y URL de punto final sobrescrito. La autenticación básica y los campos SSL (Secure Sockets Layer) afectan a la seguridad de nivel de transporte, no a la seguridad de los servicios web.
Uso del ejemplo de modalidad de proceso por lotes
$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 {{ "nombre_módulo" servicios_web.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 [[ "nombre_módulo" servicios_web.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
- Tipo de puerto: QName ("{espacionombres} nombrelocal") de un tipo de puerto definido por un atributo wsdl:portType en el archivo WSDL que identifica una interfaz.
- Puerto: QName de un puerto definido por un atributo wsdl:port dentro de un atributo wsdl:service en un archivo WSDL que identifica una implementación a la que se da preferencia.
Uso del ejemplo de modalidad de proceso por lotes
$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 {{ "nombre_módulo" servicios_web.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 [[ "nombre_módulo" servicios_web.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
La opción WebServicesServerBindPort establece dos atributos de un puerto de servicio web. Los valores inmutables identifican el puerto de un servicio web que se está modificando. Los campos de ámbito son: Módulo, Servicio web y Puerto. Los valores modificables son: Nombre de servicio WSDL y Ámbito.
El ámbito determina el ciclo de vida de la implementación del bean Java. Los valores válidos son: Solicitud (una nueva instancia para cada solicitud), Aplicación (una instancia para cada aplicación web) y Sesión (una nueva instancia para cada sesión HTTP).
El atributo de ámbito no se aplica a los servicios web que transporten un JMS (Java Message Service). El atributo de ámbito no se aplica a los enterprise beans.
El nombre de servicio WSDL identifica un servicio cuando hay más de uno con el mismo nombre de puerto. El nombre de servicio WSDL se representa como una serie de QName, por ejemplo, {espacionombres}nombrelocal.
Uso del ejemplo de modalidad de proceso por lotes
$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
La opción WebServicesClientCustomProperty soporta la configuración del parámetro de valor de nombre para la descripción del archivo de enlace del cliente de un servicio web. Los valores inmutables identifican el puerto del servicio web que se está modificando. Los campos de ámbito son: Module, Servicio web y Puerto. Los valores modificables son: nombre y valor.
El formato de los valores nombre y valor incluye una serie que representa varios pares de nombre y valor utilizando el carácter + como separador. Por ejemplo, serie de nombre = "n1+n2+n3" serie de valor = "v1+v2+v3" da como resultado pares de nombre/valor {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}},
Uso del ejemplo de modalidad de proceso por lotes
$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
La opción WebServicesServerCustomProperty soporta la configuración del parámetro de valor de nombre para la descripción del archivo de enlace del servidor de un servicio web. Los campos de ámbito son: Módulo, EJB y Servicio web. Los valores modificables de esta tarea son: nombre y valor.
El formato de estos valores incluyen una serie que representa varios pares de nombre y valor utilizando el carácter más (+) como separador. Por ejemplo, serie de nombre= "n1+n2+n3" serie de valor = "v1+v2+v3" da como resultado pares de nombre y valor: {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}.
Uso del ejemplo de modalidad de proceso por lotes
$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']]])