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

Эта страница позволяет задать параметры установки приложения Java Platform, Enterprise Edition (Java EE) в среде развертывания WebSphere Application Server. Если вы не укажете значение параметра, то будет применяться значение по умолчанию. Многие из этих параметров можно изменить и после установки приложения, открыв страницу параметров приложения J2EE.

Для того чтобы открыть эту страницу административной консоли, выберите Приложения > Создать приложение > Создать приложение J2EE, а затем укажите необходимые значения на страницах подготовки к установке приложения.

Страница Выбрать параметры установки одинаково выглядит в мастерах установки и обновления.

Предварительная компиляция файлов JSP

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

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

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

Тип данных Булевское значение
Значение по умолчанию false
Каталог для установки приложения

Каталог, в котором будет установлен файл 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}. Переменные подстановки пути можно использовать в любой процедуре установки.

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

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

Тип данных Строка
Единицы измерения Полный путь
Разослать приложение

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

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

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

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

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

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

Тип данных Булевское значение
Значение по умолчанию true
Использовать конфигурацию двоичных файлов

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

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

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

Тип данных Булевское значение
Значение по умолчанию false
Развернуть объекты EJB

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

Этот инструмент создает код, необходимый для запуска файлов EJB. Этот параметр следует выбирать в следующих случаях:
  • Файл EAR скомпонован инструментом сборки, таким как Rational Application Developer, без запуска инструмента EJBDeploy.
  • Файл EAR не был скомпонован с помощью инструмента сборки, такого как Rational Application Developer.
  • Файл EAR был скомпонован с помощью инструмента Application Assembly Tool (AAT), версия которого младше 5.0.

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

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

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

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

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

Тип данных Булевское значение
Значение по умолчанию true (false для модулей EJB 3.0)
Имя приложения

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

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

Табл. 1. Символы, которые нельзя использовать в имени. Эти символы недопустимы в имени.
Неподдерживаемые символы
  косая черта $   знак доллара '  одинарная кавычка
\  обратная косая черта =   знак равенства " двойная кавычка
* звездочка % знак процентов |   вертикальная черта
,  запятая +   знак плюса <  левая угловая скобка
:  двоеточие @ коммерческое А >  правая угловая скобка
;  точка с запятой #   решетка & амперсанд
? знак вопроса ]]> эта комбинация символов не имеет специального названия

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

Тип данных Строка
Создать MBeans для ресурсов

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

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

Тип данных Булевское значение
Значение по умолчанию true
Переопределить параметры перезагрузки классов для Web-модулей и модулей EJB

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

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

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

Тип данных Булевское значение
Значение по умолчанию false
Интервал перезагрузки в секундах

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

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

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

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

Тип данных Целое число
Единицы измерения сек
Значение по умолчанию 3
Развернуть Web-службы

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

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

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

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

Тип данных Булевское значение
Значение по умолчанию false
Проверять ввод: выкл/предупреждение/сбой

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

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

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

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

Тип данных Строка
Значение по умолчанию предупреждение
Обрабатывать вложенную конфигурацию

Указывает, нужно ли обрабатывать вложенную конфигурацию. Вложенная конфигурация состоит из файлов resource.xml и variables.xml. Если этот параметр равен true, то вложенная конфигурация загружается в среду приложения из файла .ear. Если в файле .ear нет вложенной конфигурации, то по умолчанию применяется значение false. Если файл .ear содержит вложенную конфигурацию, то по умолчанию применяется значение true.

Этот параметр влияет на установку расширенных файлов EAR. Расширенный файл EAR создается в результате экспорта установленного приложения.

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

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

Тип данных Булевское значение
Значение по умолчанию false (флажок снят)
Права доступа к файлам

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

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

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

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

Табл. 2. Наборы строк прав доступа к файлу для вариантов списков. Выберите опцию в списке или укажите строку прав доступа к файлу в текстовом поле.
Опция в списке множественного выбора Строка прав доступа к файлам
Разрешить чтение всех файлов, запретив запись .*=755
Разрешить запуск исполняемых файлов .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755
Разрешить всем чтение файлов HTML и изображений .*\.htm=755#.*\.html=755#.*\.gif=755#.*\.jpg=755

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

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

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

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

Рекомендации: Использование регулярных выражений в шаблоне имени файла позволяет сравнить всю строку URI с указанным шаблоном прав доступа к файлу. С помощью регулярных выражений можно задать более точные шаблоны для сравнения, как указано в описании API Java. Для примера предположим, что необходимо определить права доступа к следующим файлам и каталогам:bprac
Табл. 3. Примеры URI для операций доступа к файлу. Результаты отображаются в после этой таблицы.
1 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war
2 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp
3 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF/MANIFEST.MF
4 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/WEB-INF/classes/MyClass.class
5 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/mydir/MyClass2.class
6 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF

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

  • Шаблону 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
Сравнение с шаблонами даст следующие результаты:
  • Для каталога MyApp.ear будет установлено значение 755
  • Для каталога MyWarModule.war будет установлено значение 755
  • Для каталога MyWarModule.war будет установлено значение 755
Рекомендации: Во всех операционных системах нужно использовать обычную косую черту (/) в качестве разделителя в шаблонах пути к файлу.bprac

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

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

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

Тип данных Строка
Идентификатор компиляции приложения

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

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

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

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

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

Тип данных Булевское значение
Значение по умолчанию false
Разрешить обслуживание запросов включения с удаленных ресурсов

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

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

Тип данных Булевское значение
Значение по умолчанию false
Имя приложения бизнес-уровня

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

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

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

Тип данных Строка
Значение по умолчанию Создается приложение бизнес-уровня, имя которого совпадает с именем приложения J2EE, которое устанавливается.

WebSphere:blaname=Anyasset,blaedition=BASE

Тип диспетчеризации асинхронных запросов

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

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

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

Тип данных Строка
Значение по умолчанию Выключено



Ссылки, помеченные как (в сети), требуют подключения к Internet.

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


Имя файла: urun_rapp_installoptions.html