Utiliser le module Web version 2.4 ou antérieure lors de la migration d'applications à partir de WebSphere version 6.1 ou antérieure

Cette règle marque les modules Web version 2.5 ou ultérieure lorsqu'ils sont migrés à partir de WebSphere Application Server version 6.1 ou antérieure.

La prise en charge de modules Web version 2.5 a été introduite dans WebSphere Application Server version 7. Le format xmi des liaisons et des extensions a alors été remplacé par xml. A partir de la version 7, les liaisons au format xmi ne sont plus traitées correctement dans un module Web version 2.5 ou ultérieure.

WebSphere Application Server version 6.1 et antérieure permettait l'installation de modules Web au format web.xml avec une version 2.5. L'application s'exécutait sans erreur si elle ne tentait pas d'utiliser une fonction supplémentaire fournie par le niveau de spécification supérieur. Il était possible qu'une application déployée ne puisse pas être exécutée correctement sur des versions ultérieures de WebSphere.

Par exemple, si vous avez installé un module Web version 2.5 dans WebSphere Application Server version 6.1 et défini un hôte virtuel au moment du déploiement, l'application est correctement déployée. La définition de l'hôte virtuel est enregistrée dans le fichier de liaison xmi de l'application, ibm-web-bnd.xmi. Si vous migrez ensuite ce module Web vers WebSphere version 7.0 ou ultérieure, le serveur s'attend à stocker des informations de liaison dans un fichier ibm-web-bnd.xml et non au format xmi. WebSphere Application Server reste compatible en amont, ainsi si la version du module Web est 2.4, le fichier ibm-web-bnd.xmi est correctement interprété par WebSphere version 7 ou ultérieure.

Cette non-concordance entre la version des modules Web et le type des fichiers de liaison ou d'extension peut entraîner des problèmes au niveau des environnements de déploiement du réseau et du serveur de base. Voici quelques scénarios d'erreur possibles :

Erreurs d'installation de l'application causées par la tâche WASPostUpgrade lors de la migration de l'application si celle-ci contient un module Web de version 2.5 et un fichier ibm-web-bnd.xmi. Les erreurs sont alors liées aux informations de liaison manquantes étant donné que les liaisons xmi ne sont pas lues.
Erreurs au moment du déploiement vers un serveur de base version 7 ou ultérieure ou un gestionnaire de déploiement si l'application contient un module Web version 2.5 et un fichier ibm-web-bnd.xmi.
Erreurs au moment de l'exécution dans un environnement de cellule mixte si l'application ne contient pas de liaisons mais que des liaisons sont établies au moment du déploiement dans un déploiement réseau. Cette installation génère une application avec un module Web version 2.5 et des liaisons xml. Toutefois, ces artefacts d'application ne sont pas compris par les noeuds WebSphere version 6.1. Concernant les noeuds dotés du module de fonctions de services Web, l'application peut être synchronisée avec le noeud version 6.1 mais elle ne peut pas s'exécuter car le noeud version 6.1 ne peut pas interpréter les liaisons et extensions xml. Concernant les noeuds dépourvus du module de fonctions de services Web, l'application ne peut pas être ciblée.

Lors d'une migration de la version 6.1 ou antérieure, un fichier web.xml dont le contenu est le suivant est marqué :

<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 version web-app doit être remplacée par la version 2.4. La correction automatisée modifiera la version et les informations sur le schéma, comme le montre l'exemple suivant :

< 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>

Pour plus d'informations sur les niveaux de spécification Java EE pris en charge dans les différentes versions de WebSphere Application Server, voir Spécifications et API de modèle de programmation.