Použít webový modul verze 2.4 nebo nižší při migraci aplikací z WebSphere V6.1 nebo předchozí verze

Toto pravidlo značí webové moduly s verzí 2.5 nebo vyšší, když jsou migrovány ze serveru WebSphere Application Server verze 6.1 nebo nižší.

Podpora pro webový modul verze 2.5 byla zavedena na serveru WebSphere Application Server verze 7. V tomto okamžiku se formát pro vazby a rozšíření změnil ze formátu xmi na formát xml. Od verze 7 nebudou formátované vazby xmi ve webovém modulu správně zpracovány, který je verze 2.5 nebo vyšší.

Server WebSphere Application Server V6.1 a předchozí povolené webové moduly, které mají být instalovány, měly soubor web.xml s verzí 2.5. Aplikace se spustí bez chyby, pokud se nepokusí použít další funkci poskytovanou specifikací vyšší úrovně. To může mít za následek implementovanou aplikaci, kterou nelze řádně spustit v pozdějších verzích platformy WebSphere.

Pokud jste například nainstalovali webový modul s verzí 2.5 v produktu WebSphere Application Server V6.1 a definovali jste virtuálního hostitele v době implementace, aplikace by byla úspěšně naimplementována. Definice virtuálního hostitele by měla být uložena v souboru xmi vazby aplikace ibm-web-bnd.xmi. Pokud poté tento webový modul migrujete na server WebSphere verze 7.0 nebo vyšší, bude server očekávat, že informace o vazbě budou uloženy do souboru ibm-web-bnd.xml, a nikoli ve formátu xmi. Server WebSphere Application Server zůstává zpětně kompatibilní, takže pokud má webový modul verzi 2.4, soubor ibm-web-bnd.xmi bude interpretován správně serverem WebSphere verze 7 nebo vyšší.

Tato neshoda verze webového modulu a typů vazby nebo souboru rozšíření může způsobit problémy na základním serveru a v prostředích Network Deployment. Některé z možných chybových scénářů zahrnují:

Chyby instalace aplikace z úlohy WASPostUpgrade během migrace aplikace, pokud aplikace obsahuje webový modul verze 2.5 a soubor ibm-web-bnd.xmi. Chyby v této chvíli souvisejí s chybějícími informacemi o vazbě, protože nečte vazby xmi.
Chyby při implementaci základního serveru nebo správce implementace verze 7 nebo vyšší, pokud aplikace obsahuje webový modul verze 2.5 a soubor ibm-web-bnd.xmi.
Chyby za běhu v prostředí se smíšenými buňkami, pokud aplikace neobsahuje vazby, ale jsou svázány v době implementace v síťové implementaci. Tato instalace vytvoří aplikaci s webovým modulem verze 2.5 s vazbami xml. Tyto artefakty aplikace však nejsou rozpoznány uzly WebSphere V6.1. V případě uzlů s balíkem funkcí Web Services Feature Pack může být aplikace synchronizována s uzlem verze 6.1, ale nelze ji spustit, protože uzel verze 6.1 nemůže interpretovat vazby a rozšíření xml. V případě uzlů bez balíku funkcí Web Services Feature Pack by se zacílení aplikace nezdařilo.

Při migraci z verze 6.1 a starší bude označen soubor web.xml s následujícím obsahem:

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

Verze webové aplikace by měla být upravena na verzi 2.4. Automatická oprava změní verzi a informace o schématu podle následujícího příkladu:

< span class="Code"> < ?xml version= "1.0" encoding= "UTF-8" ?>
< web-app id="ID webové aplikace "< b> verze ="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>

Další informace o úrovních specifikace Java EE podporovaných v jiných verzích serveru WebSphere Application Server viz Rozhraní API programovacího modelu a specifikace.