La actualización de aplicaciones
empresariales consiste en añadir un nuevo archivo o módulo a una aplicación instalada de
Java EE
(Java™ Platform, Enterprise Edition), o en sustituir o eliminar un módulo, archivo o aplicación
instalados.
Antes de empezar
Antes de actualizar los archivos de aplicación en un
servidor, asegúrese de que los archivos se han ensamblado en los módulos desplegables.
A continuación, consulte Formas de actualizar los archivos de aplicación empresariales y decida cómo desea actualizar los archivos de aplicación.
Puede actualizar módulos o aplicaciones de empresa utilizando la consola administrativa,
la herramienta wsadmin o la programación de Java MBean.
Estos métodos proporcionan las mismas posibilidades de actualización.
Además, asegúrese de que los archivos actualizados se pueden instalar en los
destinos de despliegue.
Acerca de esta tarea
Los pasos describen cómo actualizar las aplicaciones o los módulos
desplegados utilizando la consola administrativa.
Procedimiento
- Haga una copia de seguridad de la aplicación o del módulo instalados.
- Vaya a la página Aplicaciones de empresa de la consola
administrativa.
Pulse en el árbol de navegación de la consola.
- Exporte la aplicación a un archivo EAR o exporte un archivo de la aplicación.
Seleccione la aplicación que desea exportar y pulse Exportar o
Exportar archivo.
La exportación conserva la información de enlace.
- Con la aplicación seleccionada en la página
Aplicaciones de empresa, seleccione
Actualizar. Aparecerá la página Preparación para la actualización de la
aplicación.
- En Especifique el módulo EAR, WAR, JAR o RAR que se
subirá e instalará:
- Asegúrese de que Aplicación que se actualizará haga referencia a
la aplicación que se va a actualizar.
- Bajo
Opciones de actualización de la aplicación, seleccione la
aplicación, el módulo o el archivo instalados que desea actualizar.
La sección Valores de preparación para la
actualización de la aplicación de la ayuda en línea proporciona información
detallada sobre las opciones.
Avoid trouble: No puede añadir, eliminar ni
modificar una anotación JAX-WS (Java Application Programming Interface (API) for XML-Based
Web Services) utilizando las opciones de actualización
Sustituir o añadir un
solo archivo o
Sustituir, añadir o suprimir varios
archivos.
Estas opciones cambian un solo archivo o una aplicación parcial.
Si modifica una anotación
JAX-WS utilizando una de estas opciones, el producto no devuelve un error.
Sin embargo,
podría experimentar problemas al desplegar servicios web anotados.
gotcha
- Si ha seleccionado la opción Sustituir
toda la aplicación o Sustituir o añadir un solo módulo:
- Pulse Siguiente para visualizar un asistente para actualizar
los archivos de aplicación.
- Siga los pasos del asistente de actualización.
Este asistente de actualización, que es parecido al asistente de
instalación, proporciona campos para especificar o editar información de enlace de
aplicaciones. Consulte la información sobre cómo instalar aplicaciones utilizando la consola y sobre la página
Preparación para la instalación de la aplicación de valores de
enlace para obtener instrucciones.
Recuerde que las instrucciones de instalación tienen la información de enlace fusionada de la versión nueva y de la antigua.
Si la versión nueva tiene enlaces de artefactos de la aplicación, como nombres JNDI (Java Naming and Directory Interface) EJB (Enterprise JavaBeans), referencias de EJB o referencias de recursos, dichos enlaces formarán parte de la información de enlace fusionada.
Si no están presentes los nuevos enlaces, entonces se toman de la versión instalada (anterior).
Si no están presentes los enlaces en la versión anterior y está habilitada la opción de generación de enlaces por omisión, entonces los enlaces por omisión serán parte de la información de enlace fusionada.
Puede seleccionar si desea omitir los enlaces de la versión anterior o los de la nueva versión.
- Pulse Finalizar.
- Si no ha utilizado la página Gestionar módulos del
asistente de actualización, después de actualizar la aplicación, correlacione la
aplicación o el módulo instalados con los servidores o
clústeres.
Utilice la página a la que se accede desde la página Aplicaciones
empresariales.
- Vaya a la página Gestionar módulos. Pulse
.
- Especifique el servidor de aplicaciones donde desea instalar módulos contenidos en la aplicación y pulse Aceptar.
Puede desplegar módulos J2EE (Java 2 Platform, Enterprise Edition) 1.4 en
servidores de la versión 6 o en nodos posteriores.
Puede desplegar módulos Java EE (Java Platform, Enterprise Edition) 5 en los servidores que se encuentran en nodos de la
versión 7.x o posterior.
Puede desplegar módulos Java EE 6 a nodos de servidores de la
versión 8.x o posterior.
Puede desplegar módulos Java EE 7 a servidores en nodos de la versión 9.x.
En productos de varios servidores, también
puede desplegar módulos en clústeres.
Para desplegar módulos J2EE 1.4, los clústeres
deben contener miembros de clúster de nodos de la Versión 6 o posterior.
Para desplegar
módulos Java EE 5, los clústeres deben contener miembros del clúster de nodos de la
versión 7.x o posterior.
Para desplegar
módulos Java EE 6, los clústeres deben contener miembros del clúster de nodos de la
versión 8.x o posterior.
Para desplegar módulos Java EE 7, los clústeres deben contener miembros del clúster de nodos de la
versión 9.x.
Resultados
Si se sustituye una aplicación completa, el producto desinstala la aplicación antigua.
Si se sustituye un módulo, un archivo o una aplicación parcial, el producto elimina de la
aplicación instalada el módulo, el archivo o la aplicación parcial.
Qué hacer a continuación
Una vez instalado correctamente el módulo o el archivo de aplicación,
realice lo siguiente:
- Si se despliega un módulo o una aplicación modificados en un clúster,
propague la configuración modificada en todos los miembros del clúster en el que se despliegue la aplicación o el
módulo.
Pulse Desplegar actualización en el página
Aplicaciones de empresa para propagar la configuración cambiada en
todos los miembros del clúster en el que se despliegue la aplicación o el módulo.
Desplegar actualización actualiza de forma
secuencial la configuración en los nodos que contienen los miembros de clúster.
Nota: Si un clúster tiene más de un miembro en el mismo nodo, se detienen todos los miembros del nodo al mismo tiempo.
procedimientos recomendados: Cuando finalicen los mensajes de Instalación visualizados por la consola durante la
instalación de la aplicación o módulo, pulse Gestionar
aplicaciones para ir a la página Aplicaciones
empresariales.
No guarde los cambios de la configuración hasta después de haber desplegado los cambios.
- Guarde los cambios en la configuración.
En productos de varios servidores, después de pulsar
Guardar el producto suprime los archivos de aplicación antiguos y
copia los nuevos archivos cuando la configuración del gestor de despliegue se sincroniza
con la configuración del nodo en el que se ha instalado la aplicación.
Si la aplicación está en ejecución cuando se actualiza, dejará de ejecutarse antes de que los archivos se copien en el directorio de destino del nodo y se volverá a iniciar después de finalizar la operación de copia.
Por lo tanto, la aplicación no está disponible en el nodo durante el período de tiempo durante el que el nodo sincroniza su configuración con el gestor de despliegue.
- Si fuera necesario, reinicie la aplicación manualmente para que los cambios entren en vigor.
Si la aplicación se
actualiza durante su ejecución, detiene automáticamente la aplicación o sólo sus
componentes modificados, actualiza la lógica de la misma y reinicia la aplicación
retenida o sus componentes.
Si actualiza los metadatos de módulo mientras se ejecuta una aplicación, es posible que el reinicio de la aplicación
no sea suficiente para que los cambios entren en vigor. Por ejemplo, si cambia descriptores al ejecutar aplicaciones Java EE 6 que utilizan
anotaciones, debe instalar la aplicación. Si cambia las clases que introducen, eliminan o alteran jerarquías de clase de una aplicación y
estos cambios afectan a las clases anotadas, también debe instalar la aplicación.
- Si la aplicación que está actualizando se despliega en un servidor que tiene su
política de cargador de clases de aplicación establecida en Único
en la página de valores de servidor de aplicaciones, reinicie el servidor.