Używaj modułu WWW w wersji 2.4 lub wcześniejszej podczas migrowania aplikacji z produktu WebSphere w wersji 6.1 lub wcześniejszej

Ta reguła oznacza flagą moduły WWW w wersji 2.5 lub nowszej, gdy są one migrowane z serwera WebSphere Application Server w wersji 6.1 lub wcześniejszej.

Obsługę modułu WWW w wersji 2.5 wprowadzono na serwerze WebSphere Application Server w wersji 7. W tym czasie format powiązań i rozszerzeń został zmieniony z formatu xmi na format xml. Począwszy od wersji 7, powiązania w formacie xmi nie będą poprawnie przetwarzane w module WWW w wersji 2.5 lub nowszej.

Serwer WebSphere Application Server w wersji 6.1 i w wersjach wcześniejszych zezwalał na instalowanie modułów WWW, które miały plik web.xml w wersji 2.5. Aplikacja zostałaby uruchomiona bez błędu, jeśli nie spróbowałaby użyć dodatkowej funkcji udostępnianej w specyfikacji o wyższym poziomie. Może to spowodować wdrożenie aplikacji, która nie działa poprawnie w nowszych wersjach produktu WebSphere.

Jeśli na przykład zainstalowano moduł WWW o wersji 2.5 na serwerze WebSphere Application Server w wersji 6.1 i w czasie wdrażania zdefiniowano host wirtualny, aplikacja zostanie wdrożona pomyślnie. Definicja hosta wirtualnego zostanie zapisana w pliku xmi powiązań aplikacji, czyli w pliku ibm-web-bnd.xmi. Jeśli następnie ten moduł WWW zostanie zmigrowany do produktu WebSphere w wersji 7.0 lub nowszej, serwer będzie oczekiwał, że informacje o powiązaniach będą zapisane w pliku ibm-web-bnd.xml, a nie w formacie xmi. Serwer WebSphere Application Server zachowuje kompatybilność wsteczną, jeśli więc moduł WWW ma wersję 2.4, plik ibm-web-bnd.xmi będzie interpretowany poprawnie przez produkt WebSphere w wersji 7.

Taka niezgodność wersji i typów plików rozszerzeń modułu WWW może powodować problemy w środowiskach serwera podstawowego i wdrożenia sieciowego. Niektóre możliwe scenariusze błędów to:

• Błędy instalacji aplikacji w ramach zadania WASPostUpgrade podczas migrowania aplikacji, jeśli aplikacja zawiera moduł WWW w wersji 2.5 i plik ibm-web-bnd.xmi. Błędy występujące w tym czasie są związane z brakiem informacji o powiązaniach, ponieważ powiązania xmi nie są odczytywane.
• Błędy w czasie wdrażania do wersji 7 lub nowszej serwera podstawowego lub menedżera wdrażania, jeśli aplikacja zawiera moduł WWW w wersji 2.5 i plik ibm-web-bnd.xmi.
• Błędy w czasie wykonywania w środowisku komórek mieszanych, jeśli aplikacja nie zawiera powiązań, ale są one powiązane w czasie wdrażania w środowisku wdrożenia sieciowego. W ramach tej instalacji tworzona jest aplikacja z modułem WWW w wersji 2.5 z powiązaniami xml. Jednak te artefakty aplikacji nie są rozpoznawane przez węzły produktu WebSphere 6.1. W przypadku węzłów z pakietem Web Services Feature Pack aplikacja może być zsynchronizowana z węzłem w wersji 6.1, ale nie można jej uruchomić, ponieważ węzeł w wersji 6.1 nie może zinterpretować powiązań i rozszerzeń xml. W przypadku węzłów bez pakietu Web Services Feature Pack działanie aplikacji się nie powiedzie.

W przypadku migracji z wersji 6.1 i wcześniejszych zostanie oznaczony flagą plik web.xml z następującą treścią:

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

Wersję web-app należy zmodyfikować do wersji 2.4. Szybka poprawka w skanerze kodu źródłowego modyfikuje informacje o wersji i schemacie w sposób przedstawiony w następującym przykładzie:

<?xml version="1.0" encoding="UTF-8"?> <web-app id="WebApp_ID" version="2.4" 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>

Dodatkowe informacje na temat poziomów specyfikacji Java EE obsługiwanych w różnych wersjach serwera WebSphere Application Server można znaleźć w sekcji Interfejsy API i specyfikacje modelu programistycznego.