Usar a versão do módulo da web 2.4 ou inferior ao migrar aplicativos do WebSphere V6.1 ou anterior

Essa regra sinaliza módulos da web com uma versão 2.5 ou mais alta quando eles estão sendo migrados de um WebSphere Application Server Versão 6.1 ou inferior.

O suporte para a versão de módulo 2.5 foi introduzido no WebSphere Application Server Versão 7. Nesse momento, o formato para ligações e extensões foi alterado do formato xmi para xml. A partir da Versão 7 em diante, as ligações formatadas como xmi não serão processadas corretamente em um módulo da web que seja versão 2.5 ou mais alta.

O WebSphere Application Server V6.1 e os módulos da web anteriores com permissão para serem instalados que tinham um web.xml com uma versão 2.5. O aplicativo executaria sem erro se não tivesse tentado usar a função extra fornecida pelo nível de especificação mais alto. Isso pode resultar em um aplicativo implementado que não possa executar adequadamente em versões posteriores do WebSphere.

Por exemplo, se você tivesse instalado um módulo da web com uma versão do WebSphere Application Server 2.5 V6.1 e definido um host virtual no momento da implementação, o aplicativo seria implementado com êxito. A definição de host virtual seria salva no arquivo xmi da ligação do aplicativo, ibm-web-bnd.xmi. Então, se você migrar esse módulo da web para o WebSphere Versão 7.0 ou mais recente, o servidor esperará que as informações de ligação sejam armazenadas em um arquivo ibm-web-bnd.xml e não no formato xmi. O WebSphere Application Server permanece com compatibilidade reversa, assim, se o módulo da web tiver uma versão de 2.4, o ibm-web-bnd.xmi será interpretado adequadamente pelo WebSphere Versão 7 ou mais recente.

Essa incompatibilidade de versão do módulo da web e dos tipos de ligação ou extensão pode causar problemas no servidor base e em ambientes de implementação de rede. Alguns dos possíveis cenários de erro incluem:

erros de instalação de aplicativo a partir da tarefa WASPostUpgrade durante a migração do aplicativo, se o aplicativo contiver um módulo da web versão 2.5 e um arquivo ibm-web-bnd.xmi. Neste momento, os erros estão relacionados às informações de ligação ausentes, pois elas não leem as ligações xmi.
Erros no tempo de implementação para um servidor base Versão 7 ou mais recente ou gerenciador de implementação, se o seu aplicativo contiver um módulo da web versão 2.5 e um arquivo ibm-web-bnd.xmi.
Erros no tempo de execução em um ambiente de células mistas, se o seu aplicativo não contiver ligações, mas elas forem limitadas no tempo de implementação em uma implementação de rede. Essa instalação produz um aplicativo com um módulo da web versão 2.5 com ligações xml. Porém, esses artefatos de aplicativo não são compreendidos pelos nós do WebSphere V6.1. Para nós com o Web Services Feature Pack, o aplicativo poderia ser sincronizado para o nó V6.1, mas não poderão ser executados, porque o nó V6.1 não pode interpretar as ligações e extensões xml. Para nós sem o Web Services Feature Pack, o aplicativo falharia ao ser previsto.

Ao migrara partir da Versão 6.1 e anterior, um web.xml com o seguinte conteúdo será sinalizado:

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

A versão de aplicativo da web deve ser modificada para versão 2.4. A correção automatizada modificará a versão e as informações do esquema, conforme mostrado no exemplo a seguir:

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

Para obter informações adicionais sobre os níveis de especificação de Java EE suportados nas diferentes versões do WebSphere Application Server, consulte APIs e especificações do modelo de programação.