Следует использовать веб-модуль версии 2.4 или ниже при миграции приложений с WebSphere версии 6.1 или ниже

Это правило помечает веб-модули с версией 2.5 и выше в случае их миграции с WebSphere Application Server версии 6.1 или более ранней версии.

Поддержка веб-модулей версии 2.5 появилась в WebSphere Application Server 7. Тогда был изменен формат привязок и расширений с xmi на xml. Начиная с версии 7 привязки в формате xmi неправильно обрабатываются в веб-модуле версии 2.5 и выше.

WebSphere Application Server версии 6.1 и более ранних версий позволял устанавливать веб-модули, у которых файл web.xml имел версию 2.5. Приложение работало без ошибок, если не пыталось использовать дополнительную функциональность из новой версии спецификации. Как следствие, некоторые развернутые приложения могут неправильно работать в более поздних версиях WebSphere.

Например, если установлен веб-модуль с версией 2.5 в WebSphere Application Server 6.1 и определен виртуальный хост во время развертывания, то приложение будет успешно развернуто. Определение виртуального хоста будет сохранено в файле xmi привязок приложения - ibm-web-bnd.xmi. Если затем выполнить миграцию этого веб-модуля в WebSphere версии 7.0 или более поздней версии, то сервер будет ожидать, что информация о привязках хранится в файле ibm-web-bnd.xml, а не в формате xmi. В WebSphere Application Server сохранена обратная совместимость, поэтому если веб-модуль имеет версию 2.4, то файл ibm-web-bnd.xmi будет интерпретирован правильно в WebSphere версии 7 и выше.

Такое несоответствие версии веб-модуля и типов файла привязок или расширений может вызвать неполадки в работе базового сервера и сред сетевого развертывания. Некоторые случаи возникновения ошибок:

Ошибки установки приложения в задаче WASPostUpgrade во время миграции приложения, если оно содержит веб-модуль версии 2.5 и файл ibm-web-bnd.xmi. Ошибки в этом случае связаны с отсутствием информации о привязках, поскольку привязки xmi не читаются.
Ошибки во время развертывания на базовом сервере или в администраторе развертывания версии 7 или выше, если приложение содержит веб-модуль версии 2.5 и файл ibm-web-bnd.xmi.
Ошибки во время выполнения в среде со смешанными ячейками, если приложение не содержит привязок, но они созданы во время развертывания в среде сетевого развертывания. В результате подобной установки создается приложение с веб-модулем версии 2.5, у которого привязки в формате xml. Однако артефакты такого приложения непонятны узлам WebSphere 6.1. Для узлов с пакетом компонентов веб-служб приложение может быть синхронизировано с узлом версии 6.1, но не может работать, поскольку узел версии 6.1 не поддерживает расширения и привязки в формате xml. Для узлов без пакета компонентов веб-служб нельзя будет задать целевую среду для приложения.

При миграции с версии 6.1 или более ранней версии помечается файл web.xml со следующими данными:

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

Версию web-app следует поменять на 2.4. Автоматическое исправление изменит версию и информацию о схеме, как показано в следующем примере:

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

Дополнительная информация об уровнях спецификации Java EE, поддерживаемых в различных версиях WebSphere Application Server, приведена в разделе Спецификации и API программной модели.