Параметры модуля веб-сервера

Используйте эту страницу для просмотра и изменения параметров файла конфигурации встраиваемого модуля веб-сервера. Файл конфигурации встраиваемого модуля, plugin_cfg.xml, содержит параметры для установки связи между веб-сервером и Сервером приложений.

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

На вкладке Конфигурация можно изменять поля. На вкладке Среда выполнения можно только просматривать информацию.

Вкладка Среда выполнения доступна, только если на сервере приложений выполняются приложения, у которых есть доступ к веб-серверу, а также существует файл http_plugin.log.

Прим.: Этот раздел ссылается на один или несколько файлов протокола сервера приложений. В распределенных системах и системе IBM® i рекомендуется настроить на сервере ведение протоколов и трассировку через HPEL, вместо вывода в файлы SystemOut.log, SystemErr.log, trace.log и activity.log. HPEL можно использовать вместе со штатными средствами z/OS для ведения протоколов. При использовании HPEL можно получить доступ ко всей информации протоколов и трассировки с помощью инструмента командной строки LogViewer из каталога bin профайла сервера. Дополнительные сведения о HPEL приведены в информации об использовании HPEL для устранения неполадок приложений.

Игнорировать неполадки DNS при запуске веб-сервера

Указывает, должен ли встраиваемый модуль игнорировать ошибки в конфигурации DNS в процессе запуска.

Это поле соответствует элементу IgnoreDNSFailures из файла plugin-cfg.xml.

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

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

Информация Значение
Тип данных Строка
Значение по умолчанию false

Интервал обновления конфигурации

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

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

Информация Значение
Тип данных Целое число
Значение по умолчанию 60 секунд.

Имя файла конфигурации встраиваемого модуля

Задает имя файла конфигурации встраиваемого модуля. Сервер приложений по умолчанию генерирует файл plugin-cfg.xml. Файл конфигурации идентифицирует приложения, серверы приложений, кластеры и порты HTTP для веб-сервера. Веб-сервер использует этот файл для доступа к приложениям, развернутым на различных серверах приложений.

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

Если требуется другое расположение, укажите его в инструменте настройки модулей (pct), затем запустите новый сценарий configureWebserver, созданный процессом установки в системе WebSphere Application Server.

При выборе встраиваемого модуля веб-сервера во время процесса установки программа установки по возможности настроит веб-сервер на распознавание соответствующего расположения файла plugin-cfg.xml. По умолчанию файл конфигурации встраиваемого модуля устанавливается в каталог каталог-встраиваемого-модуля/config/имя-веб-сервера.

Программа установки добавляет к конфигурации веб-сервера директиву, которая задает расположение файла plugin-cfg.xml.

Для удаленных веб-серверов необходимо скопировать файл из локального каталога, в котором установлен сервер приложений, в удаленную систему. Это называется распространением файла конфигурации встраиваемого модуля. Если в качестве веб-сервера используется IBM HTTP Server не ниже версии 6.1, то WebSphere Application Server может автоматически распространить файл конфигурации встраиваемого модуля по удаленным системам, используя транспортный протокол HTTP.

Щелкнув на Показать можно просмотреть текущий файл конфигурации встраиваемого модуля.

Информация Значение
Тип данных Строка
Значение по умолчанию plugin-cfg.xml

Автоматически генерировать файл конфигурации встраиваемого модуля

Для автоматической генерации файла конфигурации встраиваемого модуля на удаленном веб-сервере:
  • Это поле должно быть отмечено.
  • Служба конфигурации встраиваемого модуля должна быть включена
Если служба конфигурации встраиваемого модуля включена, файл конфигурации встраиваемого модуля веб-сервера генерируется автоматически всякий раз когда:
  • Администратор WebSphere Application Server определяет новый веб-сервер.
  • На сервере приложений развертывается приложение.
  • Удаляется приложение.
  • Обновляется и сохраняется определение виртуального хоста.

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

[AIX Solaris HP-UX Linux Windows] Важное замечание: Когда файл конфигурации встраиваемого модуля генерируется, в его список виртуальных хостов не включается admin_host. Добавление admin_host в список виртуальных хостов описано в статье Information Center "Разрешение доступа веб-серверов к административной консоли".

Автоматически распространять файл конфигурации встраиваемого модуля

Указывает, должен или нет сервер приложений автоматически распространить копию измененного файла конфигурации встраиваемого модуля на веб-сервер.
  • Это поле должно быть отмечено.
  • Служба конфигурации встраиваемого модуля должна быть включена
  • В среде Network Deployment агент узла WebSphere Application Server должен находиться на узле веб-сервера, связанного с измененным файлом конфигурации модуля.
По умолчанию это поле выбрано.
Прим.: Файл конфигурации модуля может быть автоматически распространен на удаленный веб-сервер, только если этим сервером является IBM HTTP Server версии не ниже 6.1, и работает его сервер администрирования.

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

[AIX Solaris HP-UX Linux Windows] Для распределенных платформ можно убедится в успешности выполнения автоматического распространения с помощью сообщений в файле диспетчера развертывания SystemOut.log.

[z/OS] Для платформы z/OS можно убедится в успешности выполнения автоматического распространения с помощью сообщений в файле протокола задания TSO.

Имя файла хранилища ключей встраиваемого модуля

Задает полный путь и имя файла базы данных, содержащего связки ключей безопасности, которые встраиваемый модуль веб-сервера использует для запросов HTTPS. Этот файл расположен на веб-сервере, который связан со встраиваемым модулем. После того как полный путь и имя файла базы данных заданы, вы можете:
  • Щелкнув на Работа с ключами и сертификатами, изменить этот файл.
  • Щелкнув на Скопировать в каталог хранилища ключей веб-сервера, добавить копию этого файла в каталог хранилища ключей веб-сервера.
Информация Значение
Тип данных Строка
Значение по умолчанию Нет

Путь и имя файла конфигурации встраиваемого модуля

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

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

Путь и имя файла хранилища ключей встраиваемого модуля

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

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

Ведение протоколов встраиваемого модуля

Задает расположение файла http_plugin.log. Также указывает область действия сообщений в протоколе.

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

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

Имя файла протокола - полный путь к файлу протокола ошибок встраиваемого модуля.

Информация Значение
Тип данных Строка
Значение по умолчанию каталог-встраиваемого-модуля/logs/имя-веб-сервера/http_plugin.log

Укажите путь файла http_plugin.log.

Уровень протокола - уровень детализации сообщений, выводимых в протокол встраиваемым модулем. Можно задать одно из следующих значений для этого атрибута:
  • Трассировка. Все этапы процесса запроса подробно заносятся в протокол.
  • Статистика. В протокол заносится сервер, выбранный для каждого запроса, и другая информация о балансировке загрузки, относящаяся к обрабатываемому запросу.
  • Предупреждение. В протокол заносятся все предупреждения и сообщения об ошибках, которые создаются при аварийной обработке запроса.
  • Ошибка. В протокол заносятся только сообщения об ошибках, которые создаются при аварийной обработке запроса.
  • Отладка. В протокол заносятся все критические шаги, выполняемые в процессе обработки запросов.
  • Подробно. В протокол заносится вся информация о запросах и ответах.

Если уровень протокола на задан, то используется значение по умолчанию Ошибка.

Будьте осторожны, устанавливая уровень Трассировка. На этом уровне в протокол заносится много сообщений, что может привести к быстрому заполнению дискового пространства. Уровень Трассировка никогда не должен использоваться в нормально работающей среде, потому что он неблагоприятно влияет на производительность.

[AIX Solaris HP-UX Linux Windows][IBM i][z/OS] Важное замечание: Если модуль и веб-сервер работают в системе AIX, HP-UX, Linux или Solaris, то изменения уровня протокола в файле plugin-cfg.xml не применяются динамически. Необходимо перезапустить веб-сервер, для того чтобы изменения вступили в силу. Например, в Solaris, если веб-сервер не будет перезапущен, в файле каталог-модуля/logs/http_plugin.log появится следующее сообщение об ошибке:
ERROR: ws_config_parser:handleLogEnd:
Невозможно открыть файл протокола 
'/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
Информация Значение
Тип данных Строка
Значение по умолчанию Ошибка


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