Utilizar la versión 2.4 o inferior del módulo web al migrar aplicaciones de WebSphere V6.1 o anterior

Esta regla marca los módulos web con una versión 2.5 o posterior cuando se migran desde WebSphere Application Server Versión 6.1 o anterior.

El soporte para la versión 2.5 del módulo web se introdujo en WebSphere Application Server Versión 7. En ese momento el formato de los enlaces y extensiones cambió de xmi a xml. A partir de la versión 7, los enlaces con formato xmi no se procesarán correctamente en un módulo web que sea de la versión 2.5 o posterior.

WebSphere Application Server V6.1 y anterior permitía la instalación de módulos web que tuvieran un web.xml con una versión 2.5. La aplicación se ejecutaría sin error si no intentaba utilizar funciones adicionales proporcionadas por el nivel de especificación más alto. Esto puede dar lugar a una aplicación desplegada que no se pueda ejecutar correctamente en versiones posteriores de WebSphere.

Por ejemplo, si ha instalado un módulo web con una versión de 2.5 en WebSphere Application Server V6.1 y ha definido un host virtual en el momento del despliegue, la aplicación se desplegaría satisfactoriamente. La definición de host virtual se guardaría en el archivo xmi de enlace de la aplicación, ibm-web-bnd.xmi. Si a continuación migra ese módulo web a WebSphere Versión 7.0 o posterior, el servidor esperará que la información de enlace se almacene en un archivo ibm-web-bnd.xml en lugar de con el formato xmi. WebSphere Application Server continúa siendo compatible con versiones anteriores, de forma que si el módulo web tiene una versión 2.4, ibm-web-bnd.xmi será interpretado correctamente por WebSphere Versión 7 o posterior.

Esta discrepancia de versión de módulo web y tipos de archivos de enlaces o extensión puede causar problemas en el servidor base y los entornos de despliegue de red. Algunos de los posibles escenarios de error incluyen:

Errores de instalación de la aplicación de la tarea WASPostUpgrade durante la migración de la aplicación si la aplicación contiene un módulo web de la versión 2.5 y un archivo ibm-web-bnd.xmi. Los errores en este momento están relacionados con la información de enlace que falta dado que no lee los enlaces xmi.
Errores en tiempo de despliegue en un servidor base o gestor de despliegue de la versión 7 o superior si la aplicación contiene un módulo web de la versión 2.5 y un archivo ibm-web-bnd.xmi.
Errores en tiempo de ejecución en un entorno de celda mixta si la aplicación no contiene enlaces pero están enlazados en tiempo de despliegue en un despliegue de red. Este instalación produce una aplicación con un módulo web de la versión 2.5 con enlaces xml. Sin embargo, estos artefactos de la aplicación no los entienden los nodos de WebSphere V6.1. En el caso de nodos con Web Services Feature Pack, la aplicación se podría sincronizar con el nodo de la versión 6.1 pero no podría ejecutarse porque el nodo de la versión 6.1 no puede interpretar las extensiones ni los enlaces xml. En el caso de nodos sin Web Services Feature Pack, la aplicación fallaría como destino.

Al migrar desde la versión 6.1 y anterior, se señalará un web.xml con el contenido siguiente:

<web-app id="WebApp_Id" version="2.5"
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
...
</web-app>

La versión de web-app se debe modificar a la versión 2.4. La corrección automática modificará la versión y la información del esquema como se muestra en el siguiente ejemplo:

< span class="Code"> < ?xml version= "1.0" encoding= "UTF-8" ?>
< web-app id="WebApp_ID "< b> version ="2.4" < /b>
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
...
</web-app>

Para obtener información adicional sobre los niveles de especificación de Java EE soportados en las distintas versiones de WebSphere Application Server, consulte las API y especificaciones del modelo de programación.