Webmodule der Version 2.4 oder älter bei der Migration von Anwendungen von WebSphere Version 6.1 oder früher verwenden

Diese Regel markiert Webmodule mit der Version 2.5 oder höher, wenn diese von WebSphere Application Server Version 6.1 oder älter migriert werden.

Die Unterstützung für Webmodule der Version 2.5 wurde in WebSphere Application Server Version 7 eingeführt. Zu diesem Zeitpunkt wurde das Format für Bindungen und Erweiterungen von xmi in xml geändert. Ab Version 7 werden Bindungen mit dem Format xmi nicht mehr ordnungsgemäß in einem Webmodul der Version 2.5 oder höher verarbeitet.

In WebSphere Application Server Version 6.1 und früher können Webmodule installiert werden, die eine Datei web.xml der Version 2.5 enthalten. Die Anwendung wird fehlerfrei ausgeführt, wenn sie nicht versucht, zusätzliche Funktionen zu verwenden, die von der neueren Spezifikation bereitgestellt werden. Dies kann dazu führen, dass eine implementierte Anwendung in neueren Versionen von WebSphere nicht mehr ordnungsgemäß ausgeführt wird.

Wenn Sie beispielsweise ein Webmodul der Version 2.5 in WebSphere Application Server Version 6.1 installieren und während der Implementierung einen virtuellen Host definieren, wird die Anwendung erfolgreich implementiert. Die Definition des virtuellen Hosts wird in der xmi-Bindungsdatei der Anwendung, ibm-web-bnd.xmi, gespeichert. Wenn Sie dieses Modul anschließend auf WebSphere Version 7.0 oder höher migrieren, erwartet der Server, dass die Bindungsinformationen in einer Datei ibm-web-bnd.xml und nicht im xmi-Format gespeichert sind. WebSphere Application Server bleibt abwärtskompatibel. Wenn das Webmodul also Version 2.4 hat, wird die Datei ibm-web-bnd.xmi von WebSphere Version 7 und höher ordnungsgemäß interpretiert.

Diese Abweichung von Webmodulversionen und Bindungs- bzw. Erweiterungsdateitypen kann zu Problemen in den Basisserver- und Network-Deployment-Umgebungen führen. Einige der möglichen Fehlerszenarien sind im Folgenden beschrieben:

Während der Anwendungsmigration treten Fehler bei der Anwendungsinstallation in der Task WASPostUpgrade auf, wenn die Anwendung ein Webmodul der Version 2.5 und eine Datei ibm-web-bnd.xmi enthält. Diese Fehler beziehen sich auf fehlende Bindungsinformationen, da die xmi-Bindungen nicht gelesen werden.
Während der Implementierung in einem Basisserver oder Deployment Manager der Version 7 treten Fehler auf, wenn die Anwendung ein Webmodul der Version 2.5 und eine Datei ibm-web-bnd.xmi enthält.
Zur Laufzeit treten Fehler in einer heterogenen Zellenumgebung auf, wenn Ihr Anwendung keine Bindungen enthält, diese während der Implementierung in einer Network-Deployment-Umgebung gebunden wird. Bei dieser Installation wird eine Anwendung mit einem Webmodul der Version 2.5 mit xml-Bindungen erstellt. Diese Anwendungsartefakte werden von den Knoten der WebSphere Version 6.1 jedoch nicht verstanden. Für Knoten mit Web Services Feature Pack kann die Anwendung zwar mit dem Knoten der Version 6.1 synchronisiert, aber nicht ausgeführt werden, weil der Knoten der Version 6.1 die xml-Bindungen und -Erweiterungen nicht interpretieren kann. Für Knoten ohne Web Services Feature Pack schlägt die Implementierung der Anwendung fehl.

Bei der Migration von Version 6.1 und früher wird eine Datei web.xml mit dem folgenden Inhalt markiert:

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

Die web-app-Version muss in Version 2.4 geändert werden. Die automatische Korrektur ändert die Version und die Schemainformationen wie im folgenden Beispiel gezeigt:

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

Weitere Informationen zu den Java-EE-Spezifikationsversionen, die in den verschiedenen Versionen von WebSphere Application Server unterstützt werden, finden Sie unter APIs und Spezifikationen für Programmiermodelle.