[AIX Solaris HP-UX Linux Windows][z/OS]

Instalación de archivos de aplicación de empresa añadiendo los archivos de propiedades a un directorio supervisado

Puede utilizar archivos de propiedades de la aplicación para instalar archivos de aplicación empresarial en un servidor o clúster, actualizar las aplicaciones o los módulos desplegados, o desinstalar las aplicaciones o los módulos desplegados. Arrastre o copie un archivo de propiedades en un directorio supervisado y el producto realizará la acción de despliegue descrita en el archivo de propiedades. Los archivos de aplicación de empresa que puede instalar, actualizar o desinstalar utilizando archivos de propiedades incluyen archivos EAR, archivos WAR, archivos Java™ y módulos SIP (archivos SAR). Un archivo de aplicación empresarial debe cumplir la especificación Java EE (Java Platform, Enterprise Edition).

Antes de empezar

Desarrolle y ensamble el archivo EAR, JAR, WAR o SAR. Puede utilizar una herramienta de ensamblaje soportada, como IBM® Rational Application Developer para el producto de software de WebSphere para especificar enlaces y ensamblar el archivo.

A diferencia del procedimiento descrito en Instalación de archivos de aplicación empresarial añadiéndolos a un directorio supervisado, que no cambia ni la JNDI (Java Naming and Directory Interface) ni otros enlaces de aplicaciones, puede establecer los enlaces en un archivo de propiedades.

De forma predeterminada, el despliegue del directorio supervisado no está habilitado. para poder utilizar el despliegue de directorio supervisado, debe habilitarlo. Consulte Establecimiento de los valores de despliegue de directorio supervisado.

Restricción: La instalación de un archivo EAR, JAR, WAR o SAR añadiéndolo a un directorio supervisado sólo está disponible en los sistemas operativos distribuidos y en z/OS. No está soportado en sistemas operativos IBM i.

Acerca de esta tarea

Puede desplegar un archivo EAR, JAR, WAR o SAR en un servidor de aplicaciones o clúster arrastrando o copiando un archivo de propiedades de aplicación en un directorio monitoredDeployableApps/deploymentProperties supervisado. De forma predeterminada, el producto explora un directorio supervisado en busca de los archivos de propiedades nuevos, cuya frecuencia máxima es de 5 minutos. Después de encontrar un nuevo archivo de propiedades en un directorio supervisado, el producto ejecuta de forma automática el mandato wsadmin applyConfigProperties, instala la aplicación o el módulo en el servidor de aplicaciones o clúster e inicia la aplicación o módulo.

No es necesario iniciar wsadmin ni introducir ningún mandato para desplegar la aplicación o el módulo. Simplemente añada un archivo de propiedades a un directorio supervisado. El producto ejecutará el mandato wsadmin applyConfigProperties.

También puede utilizar un archivo de propiedades para actualizar o suprimir una aplicación o módulo desplegado. El servidor o clúster debe estar ejecutándose para que el producto perciba los cambios de los archivos en el directorio supervisado.

Los pasos presuponen que se utiliza un explorador de archivos gráficos para arrastrar o copiar el archivo de propiedades. Si lo prefiere, puede utilizar los mandatos del sistema operativo para copiar un archivo en un directorio monitoredDeployableApps/deploymentProperties supervisado.

Procedimiento

  1. Cree un archivo de propiedades que defina la tarea de despliegue que desea completar.

    Los ejemplos que encontrará al final del tema proporcionan archivos de propiedades de aplicación para utilizar en directorios supervisados.

    Los archivos de propiedades que utiliza en los directorios supervisados son como los archivos de propiedades descritos en el tema sobre cómo utilizar los archivos de propiedades de la aplicación para instalar, actualizar y suprimir los archivos de aplicación de empresa. No obstante, los archivos de propiedades que se utilizan para los directorios supervisados son ligeramente distintos:

    • No es necesario especificar sentencias como CreateDeleteCommandProperties=true en la cabecera.
    • Para desinstalar una aplicación de empresa, especifique DELETE=true en la cabecera de la sección de propiedades.

    Especifique solamente las operaciones de tipo de recurso de aplicación, ImplementingResourceType=Application, en el archivo de propiedades. Si el archivo de propiedades contiene un tipo de recurso de aplicación como ImplementingResourceType=Server, el producto devolverá un mensaje de error y no realizará la operación en el tipo de recurso.

    Puede utilizar un archivo de propiedades editado para instalar o actualizar una aplicación. Para extraer el archivo de propiedades de una aplicación de empresa desplegada con el fin de editarlo o utilizarlo como plantilla, ejecute el mandato extractConfigProperties:
    • Extraer propiedades de aplicación en un archivo que utilice el formato de salida de la aplicación anterior.
      AdminTask.extractConfigProperties('[-propertiesFileName myApp.props -configData Deployment=MyApplication]')

      Al ejecutar este ejemplo Jython se genera un archivo denominado myApp.props, en el que enumeran las propiedades de un objeto de configuración de aplicación, denominada MyApplication. De forma predeterminada, el mandato extractConfigProperties genera una salida en la que se muestran todas las columnas, incluidas las columnas ocultas y las no ocultas, de los valores de tarea de instalación y de datos de tarea, en filas separadas. En la fila mutables se muestran las columnas que puede editar (true), y las que no puede editar (false).

      ...
      taskName=MapModulesToServers
        mutables={false false true false false false} #readonly
        row0={module uri server ModuleVersion moduletype moduletypeDisplay} # readonly
      ...

      Este formato se muestra en el ejemplo Instalar una aplicación empresarial con varias opciones de tarea utilizando el formato de salida de la aplicación antigua. .

    • Extraer propiedades de la aplicación a un archivo que utiliza el formato de salida simple.
      AdminTask.extractConfigProperties('[-propertiesFileName myApp.props -configData Deployment=MyApplication
         -options [[SimpleOutputFormat true]]]')

      Ejecutar este ejemplo de Jython con la opción SimpleOutputFormat establecida en true genera un archivo denominado myApp.props en el que se figuran las propiedades de un objeto de configuración de la aplicación denominada MyApplication en un formato que resulta más fácil de leer. La salida muestra las columnas no ocultas de las propiedades de la aplicación, en pares del tipo nombre_columna=valor. En la salida no se incluyen las columnas ocultas de las propiedades de la aplicación.

      ...
      taskName=MapModulesToServers
      row0={ module="My EJB Module"  #readonly
             uri=MyEjbModule.jar,META-INF/ejb-jar.xml  #readonly
             server=WebSphere:cell=!{cellName},node=!{nodeName},
             server=!{serverName} }
      ...

      Este formato se muestra en el ejemplo Instalar una aplicación empresarial con varias opciones de tarea utilizando el formato de salida de la aplicación simple.

    Para obtener más información sobre cómo extraer las propiedades de la aplicación y los formatos de salida, consulte el tema sobre cómo utilizar los archivos de propiedades de la aplicación para instalar, actualizar y suprimir los archivos de aplicación empresarial.

  2. Asegúrese de que el servidor de aplicaciones o el miembro de clúster en el que desea instalar el archivo de aplicaciones de empresa se esté ejecutando.
  3. Asegúrese de que el despliegue del directorio supervisado esté habilitado.

    Consulte Establecimiento de los valores de despliegue de director supervisado.

  4. Abra un explorador de archivos y cree el directorio supervisado deploymentProperties.

    Para los servidores de aplicaciones (autónomos) base, el directorio supervisado se encuentra en el perfil del servidor de aplicaciones. Después de crear el directorio deploymentProperties, la vía de acceso del directorio es raíz_servidor_apl/profiles/nombre_perfil_servidor_apl/monitoredDeployableApps/deploymentProperties.

    Para los servidores de aplicaciones que se encuentran en un nodo gestionado (federado) de un gestor de despliegue, cree el directorio supervisado deploymentProperties en el perfil del gestor de despliegue. Después de crear el directorio deploymentProperties, la vía de acceso del directorio es raíz_servidor_apl/profiles/nombre_perfil_gestor_despliegue/monitoredDeployableApps/deploymentProperties.

    Para los clústeres, cree un directorio supervisado deploymentProperties en el perfil del gestor de despliegue. Después de crear el directorio deploymentProperties, la vía de acceso del directorio es raíz_servidor_apl/profiles/nombre_perfil_gestor_despliegue/monitoredDeployableApps/deploymentProperties.

  5. Copie el archivo de propiedades en el directorio supervisado deploymentProperties.

Resultados

El producto añade un directorio que tiene el mismo nombre que el archivo al directorio installedApps/nombre_célula del perfil.

Además, el producto graba mensajes sobre el despliegue de la aplicación en el archivo SystemOut.log, en el directorio raíz_servidor_aplicaciones/logs/nombre_servidor. Los mensajes empiezan con la clave de mensaje CWLDD.

Los mensajes indican que el producto ha desplegado el archivo de la aplicación, y que la aplicación se está ejecutando.

Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.log y activity.log en sistemas distribuidos y de IBM i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la información de registro y rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin de perfil de servidor. Consulte la información sobre la utilización de HPEL para resolver problemas de aplicaciones para obtener más información sobre la utilización de HPEL.

Para instalaciones de un directorio supervisado por el gestor de despliegue, el producto no inicia automáticamente una aplicación o módulo si el agente de nodo o el servidor no están en ejecución. Si un agente de nodo está detenido, el producto instala la aplicación o el módulo en el nivel del gestor de despliegue, pero no sincroniza los cambios con el nodo, y no inicia la aplicación ni el módulo. Los cambios se producirán en el nodo la próxima vez que el agente esté en ejecución y se produzca una sincronización de nodo. Si el servidor se ha detenido, pero el agente de nodo se está ejecutando, el producto instala la aplicación o el módulo y sincroniza los cambios con el nodo, pero no inicia el servidor.

Ejemplo

En los archivos de propiedades de ejemplo siguientes se proporcionan plantillas que puede modificar para desplegar las aplicaciones:

Instalar una aplicación empresarial en un destino de despliegue

Tabla 1. Propiedades obligatorias. Especifique las propiedades de esta tabla en el archivo de propiedades.
Propiedad Descripción
Name Especifica el nombre de la aplicación que se va a instalar.
TargetServer Especifica el nombre del servidor en el que se va a instalar la aplicación
TargetNode Especifica el nombre del nodo en el que se va a instalar la aplicación
EarFileLocation Especifica la ubicación del archivo EAR. Proporcione un nombre de vía de acceso totalmente calificada.
#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
TargetServer=!{serverName}
TargetNode=!{nodeName}
EarFileLocation=/temp/HelloWorld.ear
#TargetCluster=cluster1

EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell
nodeName=myNode
serverName=myServer

Instalar una aplicación empresarial con varias opciones de tarea utilizando el formato de salida de la aplicación antigua

Las propiedades de ejemplo instalan una aplicación de empresa con las opciones de la tarea. En el archivo de propiedades se muestran todas las columnas, incluidas las columnas ocultas y las no ocultas, de los valores de tarea de instalación y de datos de tarea, en filas separadas. En la fila mutables se muestran las columnas que puede editar (true), y las que no puede editar (false).

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=!{applicationName}
EarFileLocation=c:/temp/HelloWorld.ear

#
# SubSection 1.0.2 # MapModulesToServers Section. taskName
# and row0 should not be edited. row0 contains column names
# for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=MapModulesToServers
  mutables={false false true false false false} #readonly
  row0={module uri server ModuleVersion moduletype moduletypeDisplay} # readonly
  row1={“My Web Module” myWebModule.war,WEB-INF/web.xml 
  WebSphere:cell=!{cellName},node=!{nodeName},server=!{serverName} 14
  moduletype.web "Web Module"}
  row2={"My EJB module" MyEjbModule.jar,META-INF/ejb-jar.xml
  WebSphere:cell=!{cellName},node=!{nodeName},server=
  !{serverName} 13 moduletype.ejb "EJB Module"}


#
# SubSection 1.0.3 # MapRolesToUsers Section. taskName and
# row0 should not be edited. row0 contains column names for
# the tasks.
#ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=MapRolesToUsers
row0={role role.everyone role.all.auth.user role.user 
role.group role.all.auth.realms role.user.access.ids 
role.group.access.ids} #readonly
mutables={false true true true true true true true} 
#readonly
row1={administrator AppDeploymentOption.No 
AppDeploymentOption.No "adminuser" "admingroup" 
AppDeploymentOption.No "" ""}


#
# SubSection 1.0.4 # BindJndiForEJBNonMessageBinding 
# Section. taskName and row0 should not be edited. row0 
# contains column names for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
#Properties
#
taskName=BindJndiForEJBNonMessageBinding
row0={EJBModule EJB uri JNDI ModuleVersion 
localHomeJndi remoteHomeJndi} #readonly
mutables={false false false true false true true} #readonly
row1={"My EJB module" myEjb myEjbModule.jar,META-INF/ejb-
jar.xml myEjb 20 "" “"}


#
# SubSection 1.0.5 # MapEJBRefToEJB Section. taskName and 
# row0 should not be edited. row0 contains column names for
# the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
#Properties
#
taskName=MapEJBRefToEJB
row0={module EJB uri referenceBinding class JNDI 
ModuleVersion} #readonly
mutables={false false false false false true false} 
#readonly
row1={"My EJB module" myEJB MyEjbModule.jar,META-INF/ejb-
jar.xml myEJB com.ibm.defaultapplication.Increment 
Increment 23}

#
# SubSection 1.0.6 # DataSourceFor20EJBModules Section.
# taskName and row0 should not be edited. row0 contains
# column names for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
#
#Properties
#
taskName=DataSourceFor20EJBModules
row0={AppVersion EJBModule uri JNDI resAuth 
login.config.name auth.props dataSourceProps} #readonly
mutables={false false false true true true true true} 
#readonly
row1={13 "My EJB module" MyEjbModule.jar,META-INF/ejb-
jar.xml MyDataSource cmpBinding.perConnectionFactory "" ""
 ""}

#
# SubSection 1.0.7 # DataSourceFor20CMPBeans Section.
# taskName and row0 should not be edited. row0 contains 
# column names for the task.#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=DataSourceFor20CMPBeans
row0={AppVersion EJBVersion EJBModule EJB uri JNDI resAuth
login.config.name auth.props} #readonly
mutables={false false false false false true true true 
true} #readonly
row1={13 13 "My EJB module" MyEjb MyEjbModule.jar,META-
INF/ejb-jar.xml myDataSource
cmpBinding.perConnectionFactory "" ""}

#
# SubSection 1.0.8 # MapWebModToVH Section. taskName and 
# row0 should not be edited. row0 contains column names for
# the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}

#
# Properties
#
taskName=MapWebModToVH
row0={webModule uri virtualHost} #readonly
mutables={false false true} #readonly
row1={"My Web Application" MyWebModule.war,WEB-INF/web.xml 
default_host}
#


#
# SubSection 1.0.9 # CtxRootForWebMod Section. taskName and
# row0 should not be edited. row0 contains column names for
# the task.#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=CtxRootForWebMod
row0={webModule uri web.contextroot} #readonly
mutables={false false true} #readonly
row1={"My Web Application" MyWebModule.war,WEB-INF/web.xml
/}


#
# SubSection 1.0.10 # MapSharedLibForMod Section. taskName
# and row0 should not be edited. row0 contains column names
# for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=MapSharedLibForMod
row0={module uri sharedLibName} #readonly
mutables={false false true} #readonly
row2={"My Web Application" MyWebModule.war,WEB-INF/web.xml
 ""}
row1={myApp META-INF/application.xml ""}#


#
# SubSection 1.0.11 # JSPReloadForWebMod Section. taskName
# and row0 should not be edited. row0 contains column names
# for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=JSPReloadForWebMod
row0={webModule uri jspReloadEnabled jspReloadInterval} 
#readonly
mutables={false false true true} #readonly
row1={"My Web Application" MyWebModule.war,WEB-INF/ibm-web-
ext.xmi AppDeploymentOption.Yes}
#


#
# SubSection 1.0.35 # SharedLibRelationship Section. 
# taskName and row0 should not be edited. row0 contains 
# column names for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=SharedLibRelationship
row0={module uri relationship compUnitName matchTarget 
origRelationship} #readonly
mutables={false false true true true false} #readonly
row2={"My Web Application" MyWebModule.war,WEB-INF/web.xml
"" "" AppDeploymentOption.Yes ""}
row1={myApp META-INF/application.xml "" "" 
AppDeploymentOption.Yes ""}
#

EnvironmentVariablesSection
#
# Environment Variables
#
applicationName=myApp
cellName=myCell
nodeName=myNode
serverName=myServer

Instalar una aplicación empresarial con varias opciones de tarea utilizando el formato de salida simple

Las propiedades de ejemplo instalan una aplicación de empresa con las opciones de la tarea. En el ejemplo se muestran las propiedades de la aplicación que se han extraído con la opción SimpleOutputFormat. Con esta opción, el archivo de propiedades muestra las columnas no ocultas de las propiedades de la aplicación en pares del tipo columnName=value. En la salida no se incluyen las columnas ocultas de las propiedades de la aplicación. Es posible que observe que al extraer los archivos de propiedades de la aplicación con la opción SimpleOutputFormat se genere un formato que resulte más fácil de leer y editar.

#
   # Header
   #
   ResourceType=Application
   ImplementingResourceType=Application 

# Properties
Name=!{applicationName}
EarFileLocation=c:/temp/HelloWorld.ear

#
# SubSection 1.0.2 # MapModulesToServers Section. taskName
# and lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#         

#
# Properties
#
taskName=MapModulesToServers
row0={ module="My EJB Module"  #readonly
       uri=MyEjbModule.jar,META-INF/ejb-jar.xml  #readonly
       server=WebSphere:cell=!{cellName},node=!{nodeName},
       server=!{serverName} }
row1={ module="My Web Module"  #readonly
       uri=myWebModule.war,WEB-INF/web.xml  #readonly
       server=WebSphere:cell=!{cellName},node=!{nodeName},
       server=!{serverName} }


#
# SubSection 1.0.3 # MapRolesToUsers Section. taskName and
# lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=MapRolesToUsers
row0={ role="All Role"  #readonly
       role.everyone=AppDeploymentOption.No
       role.all.auth.user=AppDeploymentOption.Yes
       role.user=""
       role.group=""
       role.all.auth.realms=AppDeploymentOption.No
       role.user.access.ids=""
       role.group.access.ids="" }


#
# SubSection 1.0.4 # BindJndiForEJBNonMessageBinding 
# Section. taskName and lines marked as "#readonly" should
# not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
#Properties
#
taskName=BindJndiForEJBNonMessageBinding
row0={ EJBModule="My EJB Module"  #readonly
      EJB=myEjb  #readonly
      uri=myEjbModule.jar,META-INF/ejb-jar.xml  #readonly
      JNDI=myEjb
      localHomeJndi=""
      remoteHomeJndi="" }


#
# SubSection 1.0.5 # MapEJBRefToEJB Section. taskName and 
# lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
#Properties
#
taskName=MapEJBRefToEJB
row0={ module="My EJB Module"  #readonly
      EJB=myEJB  #readonly
      uri=MyejbModule.jar,META-INF/ejb-jar.xml  #readonly
      referenceBinding=myEJB  #readonly
      class=com.ibm.defaultapplication.Increment #readonly
      JNDI=myejb }


#
# SubSection 1.0.6 # DataSourceFor20EJBModules Section. 
# taskName and lines marked as "#readonly" should not be 
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
#
#Properties
#
taskName=DataSourceFor20EJBModules
row0={ EJBModule="My EJB Module"  
       #readonly
       uri=myEjbModule.jar,META-INF/ejb-jar.xml  #readonly
       JNDI=MyDatasource
       resAuth=cmpBinding.perConnectionFactory
       login.config.name=""
       auth.props=""
       dataSourceProps="" }


#
# SubSection 1.0.7 # DataSourceFor20CMPBeans Section. 
# taskName and lines marked as "#readonly" should not be
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
# Properties
#
taskName=DataSourceFor20CMPBeans
row0={ EJBModule="My EJB Module”  #readonly
       EJB=MyEjb  #readonly
       uri=MyEjbModule.jar,META-INF/ejb-jar.xml  #readonly
       JNDI=MyDatasource
       resAuth=cmpBinding.perConnectionFactory
       login.config.name=""
       auth.props="" }


#
# SubSection 1.0.8 # MapWebModToVH Section. taskName and 
# lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}


#
# Properties
#
taskName=MapWebModToVH
row0={ webModule="My Web Application"  #readonly
       uri=myWebModule.war,WEB-INF/web.xml  
       #readonly
       virtualHost=default_host }


#
# SubSection 1.0.9 # CtxRootForWebMod Section. taskName and
# lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


# Properties
#
taskName=CtxRootForWebMod
row0={ webModule="My Web Application"  #readonly
       uri=myWebModule.war,WEB-INF/web.xml 
       #readonly
       web.contextroot=/ }


#
# SubSection 1.0.10 # MapSharedLibForMod Section. 
# taskName and lines marked as "#readonly" should not be 
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=MapSharedLibForMod
row0={ module=myApp”  #readonly
       uri=META-INF/application.xml  #readonly
       sharedLibName="" }
row1={ module="My Web Application"  #readonly
       uri=MyWebModule.war,WEB-INF/web.xml  #readonly
       sharedLibName="" }


#
# SubSection 1.0.11 # JSPReloadForWebMod Section. taskName
# and lines marked as "#readonly" should not be 
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
# Properties
#
taskName=JSPReloadForWebMod
row0={ webModule="My Web Application"  #readonly
      uri=MyWebModule.war,WEB-INF/web.xml  
           #readonly
       jspReloadEnabled=AppDeploymentOption.Yes
       jspReloadInterval=10 }


#
# SubSection 1.0.35 # SharedLibRelationship Section.
# taskName and lines marked as "#readonly" should not be 
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=SharedLibRelationship
row0={ module=myApp  #readonly
       uri=META-INF/application.xml  #readonly
       relationship=""
       matchTarget=AppDeploymentOption.Yes }
row1={ module="My Web Application"  #readonly
       uri=MyWebModule.war,WEB-INF/web.xml  
       #readonly
       relationship=""
       matchTarget=AppDeploymentOption.Yes }

EnvironmentVariablesSection
#
# Environment Variables
#
applicationName=myApp
cellName=myCell
nodeName=myNode
serverName=myServer

Actualizar un único archivo en una aplicación empresarial desplegada

Las propiedades de ejemplo añaden un archivo único a una aplicación desplegada:

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
Update=true
operationType=add
contentType=file
contentURI=test.war/com/ibm/addMe.jsp
contentFile=/temp/addMe.jsp

Eliminar un único archivo de una aplicación empresarial desplegada

Las propiedades de ejemplo suprimen un archivo único de una aplicación desplegada:

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
Update=true
operationType=delete
contentType=file
contentURI=test.war/com/ibm/addMe.jsp

Actualizar un solo módulo de una aplicación empresarial desplegada

Las propiedades de ejemplo añaden un archivo único a una aplicación desplegada: module to a deployed application:

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
Update=true
operationType=add
contentType=moduleFile
#contextRoot=”/mywebapp” # required for web module only
contentURI=Increment.jar
contentFile=/apps/app1/Increment.jar
deployEJB=false

Eliminar un solo módulo de una aplicación empresarial desplegada

Las propiedades de ejemplo suprimen un módulo único de una aplicación desplegada:

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
Update=true
operationType=delete
contentType=moduleFile
contentURI=test.war

Sustituir, añadir o suprimir varios archivos de una aplicación empresarial desplegada

Esta opción especifica actualizar múltiples archivos de una aplicación instalada con la subida de un archivo comprimido. Dependiendo del contenido del archivo comprimido, un solo uso de esta opción puede sustituir, añadir y suprimir archivos en la aplicación instalada. Cada entrada en el archivo comprimido se trata como un solo archivo, y la vía de acceso del archivo desde la raíz del archivo comprimido se trata como la vía de acceso relativa del archivo en la aplicación instalada.

Para sustituir un archivo, un archivo en el archivo comprimido debe tener la misma vía de acceso relativa que el archivo que se va a actualizar en la aplicación instalada.

Para añadir un nuevo archivo a la aplicación instalada, un archivo en el archivo comprimido debe tener una vía de acceso relativa distinta a la de los archivos en la aplicación instalada.

La vía de acceso relativa del archivo en la aplicación instalada está formada por la concatenación de la vía de acceso relativa del módulo, si el archivo está dentro de un módulo, y la vía de acceso relativa del archivo a partir del directorio raíz del módulo separada por una barra inclinada (/).

Para eliminar un archivo de la aplicación instalada, especifique metadatos en el archivo comprimido utilizando un archivo denominado META-INF/ibm-partialapp-delete.props en cualquier ámbito de archivador. El archivo ibm-partialapp-delete.props debe ser un archivo ASCII que enumera los archivos que se van a suprimir en ese archivador con una entrada por cada línea. La entrada puede contener un patrón de serie como, por ejemplo, una expresión regular que identifique varios archivos. Las vías de acceso de los archivos que se van a suprimir debe ser relativa a la vía de acceso de archivador que incluye el archivo META-INF/ibm-partialapp-delete.props.

Para obtener más información sobre los metadatos del archivo .props que se incluirán en los archivos comprimidos, consulte la sección "Sustituir, añadir o suprimir varios archivos" del apartado Valores de preparación para la actualización de la aplicación.

Las propiedades de ejemplo utilizan el archivo comprimido myAppPartial.zip para actualizar una aplicación desplegada denominada hello:

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
Update=true
operationType=update
contentType=partialapp
contentFile=/temp/MyApp/myAppPartial.zip

Sustituir toda la aplicación empresarial desplegada

Las propiedades de ejemplo actualizan toda la aplicación desplegada:

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
Update=true
operationType=update
contentType=app
contentFile=/apps/app1/newApp1.ear
useDefaultBindings=true

Desinstalar una aplicación de un destino de despliegue

The example properties uninstall a deployed application:

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application
DELETE=true

# Properties
Name=hello

Editar las opciones de despliegue de una aplicación desplegada

Las propiedades de ejemplo actualizan las opciones de despliegue de una aplicación desplegada:

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application

# Properties
Name=!{applicationName}

#
# SubSection 1.0.1 # AppDeploymentOptions Section. taskName
# and row0 should not be edited. row0 contains column names
# for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=AppDeploymentOptions
row1={$(APP_INSTALL_ROOT)/$(CELL)
AppDeploymentOption.Yes 
AppDeploymentOption.No 
AppDeploymentOption.No 
AppDeploymentOption.No 
"" 
off .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 
"WASX.SERV1 [x0617.27]" 
AppDeploymentOption.No 
AppDeploymentOption.No}
mutables={true true true true true true true true false true true}
row0={installed.ear.destination
distributeApp 
useMetaDataFromBinary 
createMBeansForResources 
reloadEnabled 
reloadInterval 
validateinstall 
filepermission 
buildVersion 
allowDispatchRemoteInclude 
allowServiceRemoteInclude} #readonly

#
EnvironmentVariablesSection
#
#
#Environment Variables
applicationName=newhello

Editar las propiedades de despliegue de módulo web

Las propiedades de ejemplo editan las propiedades de despliegue de un módulo web:

#
# WebModuleDeployment
#
ResourceType=WebModuleDeployment
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=
:WebModuleDeployment=uri#web.war


#
#Properties
#
startingWeight=90000 #integer,required,default(1)
deploymentId=1 #required
classloaderMode=PARENT_FIRST ENUM(PARENT_FIRST|PARENT_LAST),default(PARENT_FIRST)
altDD=null
uri=web.war #required
#applicationDeployment=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=
#ObjectName(ApplicationDeployment)


EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell
applicationName=myApp 

Qué hacer a continuación

Si el archivo de propiedades despliega una aplicación o un módulo, pruebe la aplicación o el módulo desplegado. Por ejemplo, escriba el URL de una aplicación desplegada en un navegador web, y examine el rendimiento de la aplicación.

Si el despliegue no resulta satisfactorio, lea los mensajes del archivo SystemOut.log, arregle la condición de error, y vuelva a añadir el archivo de propiedades al directorio supervisado nuevo.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_install_dragdrop_prop
File name: trun_app_install_dragdrop_prop.html