Formas de actualizar los archivos de aplicación empresariales

Puede actualizar los archivos de aplicación Java™ Platform, Enterprise Edition (Java EE) desplegados en un servidor o un clúster de varias formas.

Tabla 1. Formas de actualizar archivos de aplicación. Puede actualizar los archivos de aplicación utilizando la consola, wsadmin, programación o herramientas de despliegue
Opción Método Comentarios Iniciar después de actualizar
Asistente de actualización de la consola administrativa

Consulte Actualización de aplicaciones empresariales con la consola.

Para eliminar un solo archivo de una aplicación o módulo Java EE, consulte el tema sobre la eliminación de archivos de empresa.

En resumen, siga estos pasos:
  1. Vaya a la página Aplicaciones empresariales. Pulse Aplicaciones > Tipos de aplicación > Aplicaciones empresariales de WebSphere en el árbol de navegación de la consola.
  2. Seleccione la aplicación que desee actualizar y pulse Actualizar.
  3. En la página Preparación para la actualización de la aplicación, identifique la aplicación, el módulo o los archivos que se deben actualizar y pulse Siguiente.
  4. Siga los pasos del asistente de instalación y pulse Finalizar.
En la página Preparación para la actualización de la aplicación:
  • Utilice Aplicación completa para actualizar un archivo .ear.
  • Utilice Un solo módulo para actualizar un archivo .war, .sar, .jar de enterprise bean o .rar de conector.
  • Utilice Un solo archivo para actualizar un archivo que no sea un archivo .ear, .war, .sar, .jar de EJB o .rar.
  • Utilice Aplicación parcial para actualizar o eliminar varios archivos.
En la página Apliaciones empresariales, seleccione la aplicación actualizada y pulse Iniciar.
[AIX Solaris HP-UX Linux Windows][z/OS]Directorio supervisado [AIX Solaris HP-UX Linux Windows][z/OS]Si ha instalado una aplicación o módulo añadiéndolo a un directorio supervisado, puede actualizarlo añadiendo al directorio supervisado una aplicación o módulo que tenga el mismo nombre de archivo. [AIX Solaris HP-UX Linux Windows][z/OS]Consulte el tema sobre la instalación de archivos de aplicaciones empresariales añadiéndolos a un directorio supervisado. [AIX Solaris HP-UX Linux Windows][z/OS]Después de la instalación de la aplicación o el módulo, el producto se inicia automáticamente.

Para instalaciones de un directorio supervisado por el gestor de despliegue, el producto no inicia una aplicación o un módulo automáticamente si no se está ejecutando el agente de nodos o el servidor.

[AIX Solaris HP-UX Linux Windows][z/OS]Archivos de propiedades de aplicación [AIX Solaris HP-UX Linux Windows][z/OS]Cree un archivo de propiedades que especifique que se van a actualizar los archivos de aplicaciones. A continuación, ejecute el mandato wsadmin applyConfigProperties de cualquiera de las siguientes formas:
  • En un script
  • En un indicador de mandatos
  • Añadiendo el archivo de propiedades en un directorio supervisado monitoredDeployableApps/deploymentProperties.
[AIX Solaris HP-UX Linux Windows][z/OS]Consulte el tema sobre la instalación de archivos de aplicaciones empresariales añadiéndolos a un directorio supervisado. [AIX Solaris HP-UX Linux Windows][z/OS]Después de la instalación de la aplicación o el módulo, el producto se inicia automáticamente.

Para instalaciones de un directorio supervisado por el gestor de despliegue, el producto no inicia una aplicación o un módulo automáticamente si no se está ejecutando el agente de nodos o el servidor.

Scripts wsadmin

Consulte el tema sobre la actualización de aplicaciones instaladas mediante la herramienta de scripts wsadmin.

Utilice el mandato update o el mandato updateInteractive en un script o en un indicador de mandatos. Para obtener más información sobre los mandatos update y updateInteractive, consulte el tema sobre los mandatos para el objeto AdminApp. El tema Iniciación al uso de scripts wsadmin proporciona una visión general de wsadmin. Inicie la aplicación utilizando el mandato invoke y el atributo startApplication. Para obtener más información sobre el mandato invoke, consulte el tema sobre mandatos del objeto AdminControl.
Interfaces de programas de aplicación Java

Consulte el tema sobre la utilización de programas administrativos (JMX).

Actualice las aplicaciones desplegadas completando los pasos del tema sobre la gestión de aplicaciones mediante programación. Actualice una aplicación de los modos siguientes:
  • Actualice toda la aplicación
  • Añada, sustituya o suprima varios archivos de la aplicación
  • Añada un módulo a la aplicación
  • Actualice un módulo en la aplicación
  • Suprima un módulo en la aplicación
  • Añada un archivo a la aplicación
  • Actualice un archivo en una aplicación
  • Suprima un archivo en la aplicación
Invoque el método startApplication en un bean gestionado ApplicationManager utilizando AdminControl.
Herramientas de despliegue rápido

Consulte los temas de Despliegue rápido de las aplicaciones J2EE.

En resumen, siga estos pasos:
  1. Actualice los archivos de aplicación J2EE.
  2. Configure el entorno de despliegue rápido.
  3. Cree un proyecto de formato libre.
  4. Inicie una sesión de despliegue rápido.
  5. Coloque los archivos de aplicación actualizados en el proyecto de formato libre.
Las herramientas de despliegue rápido presentan las ventajas siguientes:
  • No es necesario que ensamble los archivos de aplicación J2EE antes del despliegue.
  • No es necesario que utilice otras herramientas de instalación mencionadas en esta tabla para desplegar los archivos.
Utilice cualquiera de las opciones anteriores para iniciar la aplicación. Pulsar Iniciar en la página Apliaciones empresariales es la opción más sencilla.
Despliegue directo y recarga dinámica En resumen, siga estos pasos:
  1. Actualice el archivo de aplicación (.ear), de módulo web (.war), de enterprise bean .jar o de configuración del plug-in HTTP.
  2. Siga las instrucciones del apartado Despliegue directo y recarga dinámica para actualizar el archivo.
Si no está familiarizado con WebSphere Application Server, utilice la consola administrativa para actualizar las aplicaciones. Es la opción más sencilla.

El despliegue directo y la recarga dinámica es más difícil de realizar. Debe manipular directamente el archivo de aplicación o de módulo en el servidor donde está desplegada la aplicación.

En particular, cualquier función nueva que utilice anotaciones puede interactuar sustancialmente con el despliegue directo. Consulte la información que encontrará en El atributo metadata-complete para obtener más información sobre estas interacciones cuando se despliegan aplicaciones con el despliegue directo.

Utilice cualquiera de las opciones anteriores para iniciar la aplicación. Pulsar Iniciar en la página Apliaciones empresariales es la opción más sencilla.

Puede actualizar los archivos .ear, .jar de enterprise beans, .war de módulos web, .sar de archivos SIP (Session Initiation Protocol), .rar de conector, .jar de cliente de aplicaciones y cualquier otro archivo que utilice una aplicación instalada.

Si la aplicación se actualiza durante su ejecución, WebSphere Application Server detiene automáticamente la aplicación, actualiza la lógica de la misma y la reinicia. Si la aplicación no se inicia de forma automática, iníciela manualmente utilizando una de las opciones de Inicio. Para obtener más información sobre cómo reiniciar las aplicaciones actualizadas, consulte la sección "Comportamiento de reciclado de alta definición" en el documento técnico de IBM® WebSphere Developer: Gestión de sistemas para WebSphere Application Server V6 -- Parte 5 Opciones flexibles para actualizar aplicaciones desplegadas.

Si actualiza los metadatos de módulos mientras se ejecuta una aplicación, reiniciar la aplicación puede que no sea suficiente para que los cambios entren en vigor. Por ejemplo, si cambia descriptores en aplicaciones que ejecuten Java EE 6 y utilicen anotaciones, deberá reinstalar la aplicación. Si cambia las clases que introducen, eliminan o alteran jerarquías de clase en una aplicación y, estos cambios tienen un impacto en las clases anotadas, también deberá instalar la aplicación.

El atributo metadata-complete

Al actualizar los metadatos para un módulo web, es posible que tenga que cambiar el atributo metadata-complete.
  • Cuando metadata-complete es false, se escriben dos archivos nuevos: web_merged.xml, que contiene los resultados de la fusión en web.xml con metadatos de anotación, además de un nuevo archivo, ibm-metadata.xml, que contiene datos relacionados con anotaciones adicionales, que no se pueden almacenar en web_merged.xml. El archivo web_merged.xml también contiene metadatos adicionales que se leen en web-fragment.xml en archivos JAR debajo de WEB-INF/lib del WAR.
  • Cuando metadata-complete es true, web_merged.xml NO se genera y ibm-metadata.xml NO se crea. El archivo ibm-metadata.xml solo se genera si se genera un archivo web_merged.xml.
Nota: El atributo metadata-complete se puede omitir desde web.xml (o web-fragment.xml). Cuando se omite metadata-complete, su valor predeterminado es false.
El atributo metadata-complete se debe añadir al archivo web.xml o al archivo web_merged.xml, tal como se indica a continuación:
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.org/2011/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app_3.0.xsd" 
version="3.0" metadata-complete="true">
<display-name>TestServlet30</display-name>
</web-app>
Los archivos web.xml y web_fragment.xml se deben actualizar, si estos archivos están realizando la actualización del despliegue en directo. Si solo se actualiza web_merged.xml, se pierden los cambios de despliegue directos, si se realiza alguna acción administrativa que provoca una regeneración de web_merged.xml.
Importante: Si metadata-complete es false en web.xml, debe actualizar web.xml y web_merged.xml en el despliegue en directo de aplicaciones de Servlet (web) 2.5. Si metadata-complete es true en web.xml, debe actualizar SOLO web.xml en el despliegue directo de aplicaciones de Servlet (web) 2.5.

El proceso de web.xml en un archivo WAR y ejb-jar.xml en un archivo EJBJAR son iguales, con web_merged.xml creado para un archivo WAR si el web.xml está ausente o tiene metadata-complete establecido en false, con ejb-jar_merged.xml creado para un archivo EJBJAR, si ejb-jar.xml está ausente o tiene metadata-complete establecido en false.

En cualquier caso, se crea un ibm-metadata.xml siempre que se crea un XML fusionado. (Y solamente si se crea el XML fusionado.)

Si el despliegue cambia metadata-complete de false a true, el archivo XML (web.xml r ejb-jar.xml) se crea o sustituye, no se crea ningún archivo XML fusionado y no se crea ningún ibm-metadata.xml.

El caso adicional es para el contenido de EJB en un archivo WAR (EJB-IN-WAR). Para este caso, existen reglas complejas tradicionales:
  • El valor metadata-complete de web.xml interactúa con el proceso EJB-IN-WAR.
  • Cuando no está presente ningún contenido EJB en el archivo WAR, no se realiza ningún proceso EJB-IN-WAR.
  • El despliegue podría cambiar de forma independiente change metadata-complete de false a true para web.xml o ejb-jar.xml.
  • ibm-metadata.xml se crea cuando se crea un XML fusionado. (Y no se crea cuando tampoco se crea el archivo XML fusionado.)

Con respecto a EJB-IN-WAR, se aplican las reglas siguientes:

  • Cuando web.xml tiene metadata-complete establecido en true, y no está presente ningún ejb-jar.xml, no se realiza ningún proceso EJB-IN-WAR, aunque estén presentes anotaciones EJB en el archivo WAR.
  • Cuando web.xml tiene metadata-complete establecido en false (o cuando web.xml está ausente), y cuando no está presenta ejb-jar.xml, el proceso EJB-IN-WAR se realiza solo cuando están presentes anotaciones EJB en el archivo WAR.
  • Cuando está presente ejb-jar.xml, el valor metadata-complete del web.xml no se utiliza para determinar qué proceso EJB se realiza. Cuando está presente un ejb-jar.xml, el proceos EJB-IN-WAR que se realiza se determina mediante el valor metadata-complete del ejb-jar.xml.

Icon that indicates the type of topic Concept topic



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