Выберите параметры установки

Укажите, нужно ли в процессе установки выполнять предварительную компиляцию файлов JSP. Значение по умолчанию - нет.

Этот параметр применяется только при установке приложения в среде развертывания версии 9.0.

Если параметр Предварительная компиляция файлов JSP выбран, то установка приложения в целевой среде развертывания более ранней версии (например, 8) будет отклонена. Приложения можно развертывать только в тех целевых средах развертывания, версия которых совпадает с версией продукта. Если приложения предназначены для серверов более ранней версии, чем версия продукта, то приложения нельзя развернуть на этих серверах.

Каталог, в котором будет установлен файл EAR.

По умолчанию, файл EAR устанавливается в каталоге каталог_профайла/installedApps/имя_ячейки/имя_приложения.ear.

Возможны следующие варианты настройки:

• Не указывайте значение и оставьте поле пустым.

  Значение по умолчанию - ${APP_INSTALL_ROOT}/имя_ячейки, где переменная ${APP_INSTALL_ROOT} обозначает корневой_каталог_профайла/installedApps. К пути ${APP_INSTALL_ROOT}/cell_name добавляется каталог, имя которого совпадает с именем файла EAR устанавливаемого приложения. Таким образом, если каталог не указан, то файл EAR устанавливается в каталоге каталог_профайла/installedApps/имя_ячейки/имя_приложения.ear.

• Укажите каталог.

  Если указан Каталог для установки приложения, то приложение устанавливается в каталоге указанный_путь/имя_приложения.ear. К пути, указанному в поле Каталог для установки приложения, добавляется каталог, имя которого совпадает с именем файла EAR устанавливаемого приложения. Например, если при установке приложения Clock.ear в системе Windows указывается каталог C:/myapps, то приложение устанавливается в каталог myapps/Clock.ear. Переменной ${APP_INSTALL_ROOT} присваивается указанный путь.

• Значение ${APP_INSTALL_ROOT}/${CELL} указывается при первоначальной установке приложения.

  Если приложение планируется экспортировать из одной ячейки и в дальнейшем установить экспортированное приложение в другой ячейке, то во время первоначальной установки приложения укажите переменную ${CELL}. Например, укажите для этого параметра значение ${APP_INSTALL_ROOT}/${CELL}. При экспорте приложения создается расширенный файл EAR, содержащий приложение и его конфигурацию развертывания. Если не указана переменная ${CELL}, то конфигурация развертывания хранит в целевом каталоге имя ячейки первоначальной установки. Если указать переменную ${CELL}, то в целевом каталоге точно будет содержаться имя текущей, а не исходной ячейки.

  Важная информация: Если при установке приложения на одном сервере каталог для установки не задается, то приложение устанавливается в каталог ${APP_INSTALL_ROOT}/имя-ячейки. Если сервер был добавлен в конфигурацию с несколькими серверами (с помощью утилиты addNode), то имя ячейки новой конфигурации станет применяться в качестве имени ячейки узла администратора развертывания. Если в утилите addNode задан параметр -includeapps, то приложения, установленные до выполнения операции addNode, будут по прежнему применять каталог установки ${APP_INSTALL_ROOT}/cell_name. Однако для всех приложений, устанавливаемых после добавления сервера в сетевую конфигурацию, по умолчанию будет применяться каталог установки ${APP_INSTALL_ROOT}/имя_сетевой_ячейки. Для того чтобы переместить приложение в каталог ${APP_INSTALL_ROOT}/имя-сетевой-ячейки после выполнения операции addNode, в процессе установки явно задайте каталог установки ${APP_INSTALL_ROOT}/${CELL}. В этом случае файлы приложения можно будет найти в каталоге ${APP_INSTALL_ROOT}/имя_текущей_ячейки.
• Если приложение было экспортировано, и экспортированный файл EAR устанавливается в другой ячейке или в другом расположении, укажите ${APP_INSTALL_ROOT}/имя_ячейки/имя_приложения.ear, если не указано значение ${APP_INSTALL_ROOT}/${CELL} для начальной установки.

  Экспортированный файл EAR - это расширенный файл EAR, который содержит приложение и его конфигурацию развертывания. В конфигурации развертывания хранится значение параметра Каталог для установки приложения, которое использовалось при предыдущей установке приложения. Пока для Каталога для установки приложения не указано другое значение, расширенный файл EAR будет устанавливаться в тот же самый каталог, что и при предыдущей установке.

  Если во время первоначальной установки не указана переменная ${CELL}, то для конфигурации развертывания будет использоваться имя ячейки начальной установки в целевом каталоге. При установке в другую ячейку укажите ${APP_INSTALL_ROOT}/имя_ячейки/имя_приложения.ear, где имя_ячейки - это имя ячейки, в которой требуется установить расширенный файл EAR. Если не задать имя текущей ячейки, то в качестве имени_ячейки будет применяться имя исходной ячейки, даже при установке расширенного файла EAR в ячейку с другим именем.

• Укажите полный путь или используйте переменную pathmap.

  Полный путь можно указать явно, либо с помощью переменных подстановки пути, таких как ${MY_APPS}. Переменные подстановки пути можно использовать в любой процедуре установки.

  Переменные подстановки пути можно использовать при установке приложения в кластере, элементы которого расположены в разнородных узлах, так как в этом случае полный путь нельзя записать единственным способом. Вместе с переменной подстановки пути можно использовать переменную WebSphere Application Server ${CELL}, задающую текущее имя ячейки. Например: ${MY_APP}/${CELL}. Переменные WebSphere Application Server можно определить на странице Переменные WebSphere. Для того чтобы открыть эту страницу, выберите Среда > Переменные WebSphere.

  Предотвращение неполадок: В среде распределенной операционной системы область переменной pathmap начинается с уровня агента узла, а не с уровня сервера. Если переменная отсутствует в области уровня агента узла, ее поиск продолжается на уровне узла, затем на уровне ячейки. gotcha

Поле Каталог для установки приложения аналогично параметру Расположение (полный путь) на странице Двоичные файлы приложения.

Указывает, нужно ли развертывать двоичные файлы приложения в каталоге для установки в процессе установки и удалять эти файлы в процессе удаления приложения. По умолчанию рассылка приложения разрешена. Двоичные файлы устанавливаемого приложения развертываются в указанном каталоге.

Если продукт установлен на одном сервере, двоичные файлы удаляются после удаления продукта и сохранения обновленной конфигурации.

Если продукт установлен на нескольких серверах, двоичные файлы удаляются после удаления продукта, сохранения обновленной конфигурации и синхронизации изменений.

Если эта опция выключена, то необходимо вручную развернуть двоичные файлы приложения в целевых каталогах установки на всех узлах, выбранных для установки приложения.

Предотвращение неполадок: Если эта опция выключена, а двоичные файлы приложения не скопированы на узлы и не развернуты, то при сохранении конфигурации или синхронизации вручную исполняемые файлы приложения не будут автоматически копироваться в узлы. gotcha

Поле Разослать приложение аналогично параметру Включить рассылку двоичных файлов, их развертывание и очистку на странице Двоичные файлы приложения.

Указывает, какие описания компоновки, расширений и развертывания должен использовать сервер приложений: из файла deployment.xml, содержащего документ развертывания приложения (значение по умолчанию), либо из файла EAR. Этот параметр можно выбирать только для приложений, установленных в целевых средах развертывания версии 6.0 или выше.

Значение по умолчанию (false) соответствует использованию описания компоновки, расширений и развертываний из файла deployment.xml. Для того чтобы использовать описания компоновки, расширений и развертывания из файла EAR, включите этот параметр (true).

Поле Использовать конфигурацию двоичных файлов аналогично параметру Использовать информацию о конфигурации из двоичных файлов на странице Двоичные файлы приложения.

Указывает, следует ли запускать инструмент EJBDeploy во время установки приложения.

Если модуль EJB упакован в веб-архиве (WAR), этот параметр включать не обязательно.

Инструмент развертывания EJB запускается при установке модулей EJB 1.x или 2.x. Утилита развертывания EJB не выполняется в ходе установки модулей EJB 3.x.

Этот параметр применяется только при установке приложения в среде развертывания версии 9.0.

Если вы выберете параметр Развернуть объекты EJB и попытаетесь установить приложение в целевом узле развертывания более ранней версии, например версии 8, то установка не будет выполнена. Приложения можно развертывать только в тех средах развертывания, версия WebSphere которых совпадает с версией продукта. Если приложения предназначены для серверов более ранней версии, чем версия продукта, то приложения нельзя развернуть на этих серверах.

Кроме того, при выборе Развернуть объекты EJB и указании типа базы данных на странице Укажите параметры развертывания EJB выбранный тип базы данных заменит все ранее определенные ИД базовых программ модулей EJB. Для того чтобы применялись базовые программы, заданные на уровне отдельных модулей EJB, выберите тип базы данных "" (пустое значение) на странице Укажите параметры развертывания EJB.

Если выбран этот параметр, то выполнение программы установки может занять несколько минут.

Задает логическое имя приложения. Имя приложения должно быть уникальным в пределах ячейки и не должно содержать неподдерживаемые символы.

Имя приложения не должно начинаться с точки (.), содержать пробелы в начале или конце или включать следующие символы:

Поле Имя приложения аналогично параметру Имя на странице Параметры приложения Java EE.

Указывает, следует ли создавать MBeans для ресурсов приложения (таких как сервлеты и файлы JSP) во время запуска приложения. По умолчанию разрешено создавать MBeans.

Это поле аналогично параметру Создавать MBean для ресурсов на странице Параметры запуска.

Указывает, будут ли в продукте во время выполнения обнаруживаться изменения в классах приложения во время работы приложения. Если этот параметр включен, то при изменении классов приложения оно будет останавливаться и перезапускаться с новыми классами.

По умолчанию перезагрузка классов отключена.

Это поле аналогично параметру Переопределить параметры перезагрузки классов для веб-модулей и модулей EJB на странице Загрузка классов и обнаружение обновлений.

Задает время в секундах, через которое выполняется поиск обновленных файлов в файловой системе приложения. По умолчанию используется значение атрибута интервала обновления в файле расширения IBM® (META-INF/ibm-application-ext.xmi) файла EAR.

Атрибут интервала перезагрузки применяется только в том случае, если включена перезагрузка классов.

Для того чтобы разрешить перезагрузку, задайте значение больше нуля (например, от 1 до 2147483647). Для того чтобы отключить перезагрузку, задайте нулевое значение (0). Диапазон значений - от 0 до 2147483647.

Поле Интервал перезагрузки в секундах аналогично параметру Интервал опроса на предмет обновленных файлов на странице Загрузка классов и обнаружение обновлений.

Поддерживаемые конфигурации: Для файлов расширений и привязок IBM расширение файлов (.xmi или .xml) зависит от версии приложения или Java EE (до или после версии 5). Файл расширения или привязок IBM называется ibm-*-ext.xmi или ibm-*-bnd.xmi, где * - это тип файла расширения или привязок, такой как app, application, ejb-jar или web. Применяются следующие условия:

• Для приложений и модулей, использующих Java EE до версии 5, должно быть указано расширение .xmi.
• Для приложений и модулей, использующих Java EE версии 5 или выше, должно быть указано расширение .xml. Если в состав приложения или модуля входят файлы .xmi, то они игнорируются продуктом.

Однако модуль Java EE 5 или более поздней версии может существовать в приложении, содержащем файлы Java EE до версии 5 и использующем расширение .xmi.

Файлы ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi и ibm-portlet-ext.xmi продолжают использовать расширение .xmi.

sptcfg

Указывает, нужно ли запускать инструмент развертывания веб-служб wsdeploy во время установки приложения.

Этот инструмент генерирует код, необходимый для работы приложения, использующего веб-службы. По умолчанию инструмент wsdeploy не запускается. Включите этот параметр, если файл EAR содержит модули, использующие веб-службы, и для него еще не запускался инструмент wsdeploy (ни с помощью пункта меню Развернуть инструмента сборки, ни из командной строки).

Этот параметр применяется только при установке приложения в среде развертывания версии 9.0.

Если вы выберете параметр Развернуть веб-службы и попытаетесь установить приложение в целевом узле развертывания более ранней версии, то установка не будет выполнена. Приложения можно развертывать только в тех средах развертывания, версия которых совпадает с версией продукта. Если приложения предназначены для серверов более ранней версии, чем версия продукта, то приложения нельзя развернуть на этих серверах.

Указывает, должен ли продукт проверять ссылки приложения, заданные во время его установки или обновления. Если проверка включена, то при обнаружении неверных ссылок продукт может отправлять предупреждение или прерывать операцию.

Обычно приложение ссылается на ресурсы, указывая источники данных объектов CMP, ссылки на ресурсы или ссылки на среды ресурсов, определенные в описании приложения. При проверке проверяется, определен ли ресурс, на который ссылается приложение, в целевом узле развертывания приложения.

Выберите выкл, чтобы проверка ресурсов не выполнялась, предупреждение, чтобы при обнаружении неверных ссылок на ресурсы отправлялись предупреждения, либо сбой, чтобы при обнаружении неверных ссылок на ресурсы прерывалось выполнение операции.

Поле Проверять ввод: выкл/предупреждение/сбой аналогично параметру Проверка ссылок приложения на странице Параметры приложения Java EE.

Указывает, нужно ли обрабатывать вложенную конфигурацию. Встроенная конфигурация состоит из файлов (resource.xml, variables.xml и deployment.xml и пр.). Можно собрать информацию о развертывании продукта и сохранить ее в файл EAR приложения. Этот файл впоследствии можно установить в конфигурацию сервера через интерфейсы управления приложениями.

Один такой файл EAR приложения является расширенным файлом EAR и создается во время экспорта уже установленного приложения. Расширенные файлы EAR можно узнать по переключателю встроенной конфигурации. У расширенных EAR переключатель для обработки встроенной конфигурации по умолчанию включен. Параметры установки приложения берутся из встроенной конфигурации вне зависимости от состояния переключателя для обработки встроенной конфигурации. Во время развертывания пользователи могут переопределить значения параметров.

Процесс установки приложения зависит от состояния переключателя для обработки встроенной конфигурации, если экспортированный файл EAR (расширенный файл EAR) содержит общие библиотеки и параметры их конфигурации. Если этот переключатель включен для приложения с конфигурацией общих библиотек, приложение устанавливается с этими общими библиотеками и настраивается по встроенной конфигурации. Если этот переключатель выключен для приложения с конфигурацией общих библиотек, файл EAR устанавливается без общих библиотек и их параметры конфигурации не применяются.

Определение общей библиотеки не остается даже в том случае, если параметр обработки встроенной конфигурации выключен.

Если приложение экспортировалось из ячейки, отличной от текущей ячейки, и при первой установке приложения не была указана переменная $(CELL) для Каталога установки приложения, отмените выбор этого параметра (укажите значение false), чтобы развернуть расширенный файл EAR в каталоге каталог-профайла/installedApps/имя-текущей-ячейки. В противном случае, если этот параметр выбран (значение равно true), то расширенный файл EAR развертывается в каталоге каталог-профайла/installedApps/имя-исходной-ячейки, где имя-исходной-ячейки - это имя ячейки, в которой приложение было установлено впервые. Если при первой установке приложения в качестве Каталога установки приложения была указана переменная $(CELL), то расширенный файл EAR будет развернут в каталоге каталог-профайла/installedApps/имя-текущей-ячейки.

Задает права доступа к двоичным файлам установленного приложения, развернутым в указанном каталоге.

Права доступа к файлам можно задать только в том случае, если включена опция Разослать приложение.

Права доступа можно ввести в текстовом поле. Кроме того, некоторые стандартные права доступа к файлам можно выбрать в списке с возможностью выбора нескольких элементов. Выбранные в этом списке права доступа переопределяют права доступа, заданные в текстовом поле.

Ниже описаны права доступа, которые можно выбрать в списке с возможностью множественного выбора. При выборе нескольких вариантов они объединяются в единую строку прав доступа.

Вместо того чтобы выбирать права доступа в списке с множественным выбором, можно указать строку прав доступа в текстовом поле. Эта строка задается в следующем формате:

шаблон-имени-файла=права-доступа#шаблон-имени-файла=права-доступа

где шаблон-имени-файла - фильтр с регулярным выражением для имени файла (например, .*\\.jsp для всех файлов JSP), права-доступа - список прав доступа (ACL), а # - разделитель между несколькими записями имя-файла и права-доступа. Если # встречается в строке имя-файла, вместо него используйте \#.

Если в приложении с шаблонами имени файла и прав доступа совпадают несколько URI, то будут выбираться наиболее строгие права доступа. Например, если права доступа заданы как .*\\.jsp=775#a.*\\.jsp=754, то права доступа к файлу abc.jsp будут иметь вид: 754.

Практические рекомендации: Использование регулярных выражений в шаблоне имени файла позволяет сравнить всю строку URI с указанным шаблоном прав доступа к файлу. С помощью регулярных выражений можно задать более точные шаблоны для сравнения, как указано в описании API Java. Для примера предположим, что необходимо определить права доступа к следующим файлам и каталогам: best-practices

Сравнение с шаблонами даст следующие результаты:

• Шаблону MyWarModule.war не соответствует ни один URI
• Шаблону .*MyWarModule.war.* соответствуют все URI
• Шаблону .*MyWarModule.war$ соответствует только URI 1
• Шаблону .*\\.jsp=755 соответствует только URI 2
• Шаблону .*META-INF.* соответствуют URI 3 и 6
• Шаблону .*MyWarModule.war/.*/.*\.class соответствуют URI 4 и 5

/opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp

.*MyApp.ear$=755#.*\.jsp=644

Практические рекомендации: Во всех операционных системах нужно использовать обычную косую черту (/) в качестве разделителя в шаблонах пути к файлу.best-practices

В операционных системах Windows невозможно отменить права доступа на чтение файла. Права доступа в стиле POSIX означают следующее: чтение - 4, запись - 2, выполнение - 1. Поэтому права доступа в операционной системе Windows могут быть 5 или 7. Кроме того, в POSIX предусмотрены права доступа пользователь, группа и все. В операционной системе Windows поддерживается только пользователь. Биты группа и все игнорируются.

Указанные здесь права доступа задаются на уровне приложения. Можно также задавать права доступа для двоичных файлов приложения в конфигурации на уровне узла. На уровне узла задаются наименее ограничительные права доступа для двоичных файлов приложения. Права доступа на уровне приложения могут быть такими же, как на уровне узла, или только дополнительно ограничивать доступ.

Этот параметр аналогичен полю Права доступа к файлам на странице Двоичные файлы приложения.

Версия компиляции приложения. Это значение нельзя изменять.

Поле Идентификатор компиляции приложения аналогичен полю Компиляция приложения на странице Двоичные файлы приложения.

Определяет для приложения возможность диспетчеризации запросов включения на ресурсы веб-модулей в различных виртуальных машинах Java в среде управляемого узла через стандартный диспетчер запросов.

Это поле аналогично полю Разрешить диспетчеризацию запросов включения на удаленные ресурсы на странице Свойства диспетчеризации удаленных запросов.

Указывает, будет ли приложение J2EE обслуживать запросы включения от других приложений.

Это поле аналогично полю Разрешить обслуживание запросов включения с удаленных ресурсов на странице Свойства диспетчеризации удаленных запросов.

Указывает, создавать ли в продукте новое приложение бизнес-уровня при установке приложения Java EE, или преобразовывать это приложение Java EE в модуль композиции существующего приложения бизнес-уровня.

По умолчанию создается новое приложение бизнес-уровня со значением параметра WebSphere:blaname=Anyasset,blaedition=BASE. Если в выпадающем списке выбран пункт, соответствующий созданию бизнес-приложения, в продукте создается бизнес-приложение, имя которого совпадает с именем приложения Java EE. Если уже существует бизнес-приложение, имя которого совпадает с именем приложения Java EE, то продукт не создает бизнес-приложение; он добавляет приложение Java EE в качестве составного модуля в существующее бизнес-приложение.

Для того чтобы указать взаимосвязи зависимости от существующих общих библиотек из приложения бизнес-уровня на странице Параметры зависимости и сопоставления общих библиотек, выберите имя приложения бизнес-уровня в выпадающем списке. Общие библиотеки не отображаются, если создается новое приложение бизнес-уровня и уже существует приложение бизнес-уровня с именем по умолчанию.

Для того чтобы добавить приложение Java EE к существующему бизнес-приложению, выберите это бизнес-приложение в выпадающем списке. В продукте приложение Java EE будет преобразовано в модуль композиции приложения бизнес-уровня.

Указывает, могут ли веб-модули отправлять запросы параллельно в отдельных нитях, а если могут, то кто выступает в роли диспетчера запросов: клиент или сервер. Параллельная диспетчеризация улучшает время ответа сервлета.

Если операции зависят друг от друга, не включайте диспетчеризацию асинхронных запросов. Выберите Выключено. В этом случае параллельная диспетчеризация может привести к ошибкам.

Выберите На стороне сервера, чтобы включить на сервере параллельную диспетчеризацию запросов. Выберите На стороне клиента, чтобы включить параллельную диспетчеризацию запросов клиентом.

Опция указывает, присваиваются ли неполным целевым объектам ссылок EJB стандартные значения JNDI, или эти ссылки автоматически разрешаются.

В результате выбора этой опции включается автоматическое разрешение целевым объектам ссылок EJB, если их источником являются модули EJB 2.1 или младших версий или модули Web 2.3 или младших версий. Если эта опция включена, динамически подключаемый контейнер присваивает всем ссылкам EJB без привязки стандартные значения или автоматически их разрешает.

Если на странице Подготовка к установке приложения выбран параметр Создать привязки по умолчанию, то эту опцию выбирать не нужно. В продукте создаются стандартные значения.

Если выбран параметр Разрешить автоматическое преобразование целевых объектов ссылок EJB, все модули в приложении должны использовать одну и ту же целевую среду развертывания. Если эта опция выбрана, и не все модули приложения используют один и тот же сервер, то после нажатия кнопки Готово странице Обзор отображается предупреждение, и приложение не устанавливается. Для того чтобы установить приложение, перед нажатием кнопки Готово этот параметр необходимо отключить.

Позволяет разрешить или запретить развертывание модулей клиентов.

Выберите этот параметр (установите как true), если развертываемый файл содержит один или несколько модулей и требуется настроить записи среды для модулей клиента. Выберите эту опцию также для настройки ресурсов, таких как ссылки на EJB, ссылки на ресурсы, ссылки на среды ресурсов или ссылки на назначения сообщений. При выборе этого параметра можно просмотреть страницу Связать записи среды для модулей клиентов. При развертывании модулей клиентов на объединенном узле администратора развертывания (Объединенный) или на сервере приложений (Развернутый на сервере), выберите эту опцию и установите для параметра Узел развертывания клиента подходящее значение назначения развертывания: Объединенный или Развернутый на сервере.

При выборе этой опции модули клиента устанавливаются только в среде развертывания версии 8.0 или выше.

Позволяет развернуть модули клиента в изолированной среде развертывания (Изолированная) , на объединенном узле администратора развертывания (Объединенная) или на сервере приложений (Развернута на сервере).

Выбор режима развертывания клиента влияет на способ обработки поиска java:.Все пространства имен URL Java (глобальное, приложение, модуль и компонент) являются локальными в процессах изолированных клиентов. Пространства имен расположены на сервере в процессах объединенных и развернутых на сервере клиентов.Сервер или кластер, выбранный в качестве среды развертывания модуля клиента, определяет, где создаются эти пространства имен. Все операции поиска java: для объединенных и развернутых на сервере модулей клиентов перенаправляются на целевой сервер или кластер. Модуль клиента фактически не выполняется ан целевом сервере или кластере. Несколько экземпляров одного и того же модуля клиента совместно используют пространство имен компонента в режимах Объединенный несколько Развернутый на сервере. Выбор режима Объединенный является простым объявлением намерения запустить модуль клиента с помощью Сетевого протокола запуска Java (JNLP), но механизмы JNDI объединенного режима и режима развертывания на сервере одинаковы.

Указывает, нужно ли проверять файлы описания для опубликованных схем файлов описания Java EE. Когда выбрана эта опция, продукт анализирует каждый файл описания, чтобы определить для него версию спецификации Java EE, выбирает подходящую схему, а затем проверяет файл описания для схемы файла описания Java EE. Ошибки проверки указываются в сообщениях об ошибках.

Схема файла описания Java EE называется также DTD.

Если этот параметр выбран, то приложение или модуль можно установить только в среде развертывания версии 8.0 или более поздней.