Utilizza il modulo Web versione 2.4 o inferiore durante la migrazione delle applicazioni da WebSphere V6.1 o versione precedente

Questa regola contrassegna i moduli Web con versione 2.5 o superiore quando ne viene eseguita la migrazione da WebSphere Application Server Versione 6.1 o versione precedente.

Il supporto per il modulo Web versione 2.5 è stato introdotto in WebSphere Application Server Versione 7. Da quel momento, il formato di bind ed estensioni è passato dal formato xmi al formato xml. Dalla Versione 7 in poi, i bind formattati xmi non verranno elaborati correttamente in un modulo Web versione 2.5 o versione successiva.

WebSphere Application Server V6.1 e versioni precedenti consentivano l'installazione di moduli Web con web.xml con una versione 2.5. L'applicazione veniva eseguita senza errori se non provava ad utilizzare le funzioni supplementari fornite dal livello di specifica superiore. Il risultato può essere un'applicazione distribuita che non viene eseguita correttamente nelle versioni più recenti di WebSphere.

Ad esempio, se si installa un modulo Web con versione 2.5 in WebSphere Application Server V6.1 e si definisce un host virtuale al momento della distribuzione, l'applicazione viene distribuita correttamente. La definizione dell'host virtuale viene salvata nel file xmi del bind dell'applicazione, ibm-web-bnd.xmi. Se successivamente il modulo Web viene migrato in WebSphere Versione 7.0 o versioni successive, il server prevede che le informazioni di bind siano archiviate in un file ibm-web-bnd.xml invece che nel formato xmi. WebSphere Application Server resta compatibile con le versioni precedenti, quindi se il modulo Web ha la versione 2.4, ibm-web-bnd.xmi verrà interpretato correttamente da WebSphere Versione 7 o versioni successive.

Questa mancata corrispondenza tra la versione del modulo Web ed i tipi di file di estensione o bind può causare problemi nel server di base e negli ambienti Network Deployment. Alcuni dei possibili scenari di errore comprendono:

Errori di installazione dell'applicazione dall'attività WASPostUpgrade durante la migrazione dell'applicazione se l'applicazione contiene un modulo Web versione 2.5 ed un file ibm-web-bnd.xmi. Gli errori di questa fase sono relativi ad informazioni di bind mancanti, perché i bind xmi non vengono letti.
Errori al momento della distribuzione ad un gestore distribuzione o un server di base Versione 7 o versioni successive se l'applicazione contiene un modulo Web versione 2.5 ed un file ibm-web-bnd.xmi.
Errori al runtime in un ambiente a celle miste se l'applicazione non contiene bind ma vengono collegati al momento della distribuzione in un Network Deployment. Questa installazione produce un'applicazione con un modulo Web versione 2.5 con bind xml. Tuttavia, tali risorse dell'applicazione non vengono comprese dai nodi WebSphere V6.1. Per i nodi con Web Services Feature Pack, l'applicazione può essere sincronizzata con il nodo V6.1 ma non può essere eseguita perché il nodo V6.1 non può interpretare le estensioni ed i bind xml. Per i nodi senza Web Services Feature Pack, l'applicazione non viene raggiunta come destinazione.

Durante la migrazione dalla Versione 6.1 e versioni precedenti, viene contrassegnato un file web.xml con il contenuto riportato di seguito:

<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 versione dell'applicazione Web deve essere modificata nella versione 2.4. La correzione automatica modificherà la versione e le informazioni sullo schema, come mostrato nell'esempio seguente:

< span class="Code"> < ?xml version= "1.0" encoding= "UTF-8" ?>
< web - app id="WebApp_ID "< b> versione ="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>

Per ulteriori informazioni sui livelli di specifica Java EE supportati sulle diverse versioni di WebSphere Application Server, consultare Programming model APIs and specifications.