pluginConfiguration - Модуль веб-сервера (pluginConfiguration)

Свойства, применяемые при создании файла конфигурации модуля веб-сервера

NameTypeDefaultDescription
pluginInstallRootstring/opt/IBM/WebSphere/PluginsУстановочное расположение модуля веб-сервера в файловой системе хоста веб-сервера
webserverNamestringwebserver1Имя целевого веб-сервера для применения этой конфигурации. Применяется для создания расположения файла протокола модуля, если оно не указано с помощью параметров Имя файла протокола или Каталог файла протокола.
webserverPortint
Min: -1

Max: 65535
80Порт HTTP веб-сервера
webserverSecurePortint
Min: -1

Max: 65535
443Порт HTTPS веб-сервера
sslKeyringLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.kdbПолный путь к файлу набора ключей SSL на хосте веб-сервера
sslStashfileLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.sthПолный путь к файлу паролей SSL на хосте веб-сервера
sslCertlabelstringЗадает метку свойства в наборе ключей, применяемую модулем при запросе сертификата клиента веб-контейнером.
ipv6PreferredbooleanfalseПрименяется при обработке имени хоста сервера приложений {null} или {0} для выбора предпочитаемого типа адреса
httpEndpointRefСсылка на элемент httpEndpoint верхнего уровня (строка).defaultHttpEndpointУкажите идентификатор для конечной точки http для включения в созданный файл plugin-cfg.xml. Конечная точка определяет сервер в кластере. Значение по умолчанию: 'defaultHttpEndpoint'.
connectTimeoutПериод (с точностью до секунды)5sОпределяет максимальное время, в течение которого сервер приложений поддерживается подключение к веб-серверу. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек.
serverIOTimeoutПериод (с точностью до секунды)900sОпределяет максимальное время, в течение которого модуль веб-сервера ожидает отправки запроса или пол учения ответа от сервера приложений. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек.
wsServerIOTimeoutПериод (с точностью до секунды)Определяет максимальное время, в течение которого модуль веб-сервера ожидает отправки запроса или получения ответа веб-сокета от сервера приложений. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек.
wsServerIdleTimeoutПериод (с точностью до секунды)Определяет максимальное время ожидания дополнительного модуля веб-сервера перед прерыванием простаивающего соединения с веб-сокетом. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек.
extendedHandshakebooleanfalseПри значении true модуль веб-сервера использует расширенную процедуру согласования, чтобы определить, работает ли сервер приложений.
waitForContinuebooleanfalseПри значении false (по умолчанию) модуль веб-сервера отправляет заголовок "Expect: 100-continue" в запросах HTTP с телом сообщения. При значении true модуль веб-сервера отправляет заголовок "Expect: 100-continue" с каждым запросом HTTP. Используйте значение true, если между веб-сервером и сервером приложений находится брандмауэр и они чувствительны к запросам без тела запроса.
logFileNameПуть к файлуПолный путь к файлу протокола модуля веб-сервера. Компонент каталога должен уже существовать. Для веб-серверов Apache символ вертикальной черты в начале пути интерпретируется как внешняя конвейерная программа ведения протокола. Если значение указано, то путь переопределяет logDirLocation.
logDirLocationПуть к каталогу${pluginInstallRoot}/logs/${webserverName}Устарело: каталог, в котором находится файл http_plugin.log. См. Имя файла протокола.
serverIOTimeoutRetryint
Min: -1

Max: 65535
-1Ограничивает число повторных запросов после тайм-аута чтения или записи. Значение по умолчанию {-1} не накладывает дополнительные ограничения; число повторных попыток ограничено числом доступных серверов в кластере. Значение {0} позволяет запретить повторные попытки. Это значение действует на уровне кластера сервера и не применяется к ошибкам соединений и тайм-аутам соединений модуля HTTP или тайм-аутам веб-сокетов.
loadBalanceWeightint20Это значение динамически изменяется во время работы. Весовой коэффициент сервера снижается при каждом назначении запроса этому серверу. Если все весовые коэффициенты для всех серверов снижаются до 0 или ниже, то модуль веб-сервера переназначает все весовые коэффициенты до положительных значений.
serverRole
  • BACKUP
  • PRIMARY
PRIMARYРоль сервера определяет сервер как основной или резервный. Если основные серверы доступны, то модуль веб-сервера использует их для распределения нагрузки и автоматического переключения при сбое. Однако при отсутствии всех основных серверов модуль веб-сервера использует для распределения нагрузки и автоматического переключения при сбое только резервные серверы.
BACKUP
Резервный
PRIMARY
Основной
ESIEnablebooleantrueСвойство ESIEnable включает поддержку Edge Side Include для кэширования ответов. Это свойство предоставляет возможность выключить ESI в файле конфигурации модуля веб-сервера.
ESIMaxCacheSizeint1024ESIMaxCacheSize задает максимальный размер кэша, который по умолчанию равен 1 МБ. Это свойство позволяет переопределить значение в файле конфигурации модуля веб-сервера.
ESIInvalidationMonitorbooleanfalseESIInvalidationMonitor указывает, должен ли обработчик ESI получать аннулирования от сервера приложений. Это свойство позволяет переопределить значение в файле конфигурации модуля веб-сервера.
ESIEnableToPassCookiesbooleanfalseESIEnableToPassCookies обеспечивает возможность пересылать сеансовые cookie серверу WebSphere Application Server. Это свойство позволяет переопределить значение в файле конфигурации модуля веб-сервера.
trustedProxyEnablebooleanРазрешает применение доверенных прокси-серверов. Это свойство переопределяет значение в файле конфигурации модуля веб-сервера.
trustedProxyGroupstringСписок доверенных прокси-серверов через запятую. Это свойство переопределяет значение в файле конфигурации модуля веб-сервера.

httpEndpoint

Укажите идентификатор для конечной точки http для включения в созданный файл plugin-cfg.xml. Конечная точка определяет сервер в кластере. Значение по умолчанию: 'defaultHttpEndpoint'.

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARNДействие при сбое во время запуска конечной точки.
IGNORE
Сервер не будет выдавать предупреждения и сообщения об ошибках при обнаружении ошибки конфигурации.
WARN
Сервер будет выдавать предупреждения и сообщения об ошибках при обнаружении ошибки конфигурации.
FAIL
Сервер выдаст предупреждение или сообщение об ошибке при первом возникновении ошибки и остановится.
enabledbooleantrueПозволяет сделать конечную точку доступной или недоступной. Если значение равно true, то конечная точка активируется диспетчером для обработки запросов HTTP.
hoststringlocalhostIP-адрес, полное доменное имя хоста или краткое имя хоста, применяемые клиентом для запроса ресурса. Для выбора всех доступных сетевых интерфейсов укажите '*'.
httpPortint
Min: -1

Max: 65535
Номер порта для запросов HTTP клиента. Для выключения порта укажите значение -1.
httpsPortint
Min: -1

Max: 65535
Порт для запросов HTTP клиента, защищенных с помощью SSL (https). Для выключения порта укажите значение -1.
httpOptionsRefСсылка на элемент httpOptions верхнего уровня (строка).defaultHttpOptionsПараметры протокола HTTP для конечной точки.
sslOptionsRefСсылка на элемент sslOptions верхнего уровня (строка).Параметры протокола SSL для конечной точки.
tcpOptionsRefСсылка на элемент tcpOptions верхнего уровня (строка).defaultTCPOptionsПараметры протокола TCP для конечной точки.
accessLoggingRefСсылка на элемент httpAccessLogging верхнего уровня (строка).Конфигурация протоколов доступа HTTP для конечной точки.

httpEndpoint > httpOptions

Параметры протокола HTTP для конечной точки.

NameTypeDefaultDescription
keepAliveEnabledbooleantrueРазрешает применять поддерживаемые соединения (HTTP keepalive). Если значение равно true, соединение сохраняется активным для передачи нескольких последовательных запросов и ответов. Если значение равно false, соединение закрывается сразу после отправки ответа.
maxKeepAliveRequestsint
Min: -1
100Максимальное число запросов, допустимых для поддерживаемых соединений HTTP. Значение -1 указывает, что число не ограничено.
persistTimeoutПериод (с точностью до секунды)30sВремя, в течение которого сокет может простаивать в промежутке между обработкой запросов. Этот параметр действует только в случае применения поддерживаемых соединений. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек.
readTimeoutПериод (с точностью до секунды)60sВремя, в течение которого следует ждать завершения операции чтения в сокете после первоначального запроса на чтение. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек.
writeTimeoutПериод (с точностью до секунды)60sВремя, в течение которого следует ждать передачи очередной порции ответных данных через сокет. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек.
removeServerHeaderbooleanfalseУдаляет информацию о реализации сервера из заголовков HTTP, а также выключает страницу приветствия профайла Liberty по умолчанию.
NoCacheCookiesControlbooleantrueПозволяет пользователю указать, приводит ли наличие заголовка Set-Cookie к обновлению заголовка Cache-Control с использованием соответствующего значения no-cache. При этом также добавляется заголовок Expires.
AutoDecompressionbooleantrueУправляет автоматическим развертыванием данных тела входящего запроса в канале HTTP.

httpEndpoint > sslOptions

Параметры протокола SSL для конечной точки.

NameTypeDefaultDescription
sessionTimeoutПериод (с точностью до секунды)1dВремя, в течение которого следует ждать завершения операции чтения или записи через сокет. Это значение переопределяется тайм-аутом, заданным на уровне протокола. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек.
suppressHandshakeErrorsbooleanfalseОтключить протоколирование ошибок процедуры согласования SSL. Ошибки процедуры согласования SSL могут возникать во время нормальной работы, но эти сообщения могут быть полезны в случае неполадок SSL.
sslRefСсылка на элемент ssl верхнего уровня (строка).Набор конфигураций SSL по умолчанию. Значение по умолчанию: defaultSSLSettings.
sslSessionTimeoutПериод (с точностью до миллисекунды)8640msПредельное значение тайм-аута для сеанса SSL в канале SSL. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m), секунды (s) или миллисекунды (ms). Например, укажите 500 миллисекунд как 500ms. Одна запись может включать несколько значений. Так, 1s500ms равно 1,5 сек.

httpEndpoint > tcpOptions

Параметры протокола TCP для конечной точки.

NameTypeDefaultDescription
inactivityTimeoutПериод (с точностью до миллисекунды)60sВремя, в течение которого следует ждать завершения операции чтения или записи через сокет. Это значение переопределяется тайм-аутом, заданным на уровне протокола. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m), секунды (s) или миллисекунды (ms). Например, укажите 500 миллисекунд как 500ms. Одна запись может включать несколько значений. Так, 1s500ms равно 1,5 сек.
soReuseAddrbooleantrueДопускает немедленное повторное связывание с портом при отсутствии активного получателя запросов.
addressIncludeListstringРазделенный запятыми список адресов, которым разрешены входящие соединения в этой конечной точке. Можно указать адреса IPv4 или IPv6. Все значения в адресе IPv4 или IPv6 должны задаваться числом или символом подстановки звездочка.
addressExcludeListstringРазделенный запятыми список адресов, которым не разрешены входящие соединения в этой конечной точке. Можно указать адреса IPv4 или IPv6. Все значения в адресе IPv4 или IPv6 должны задаваться числом или символом подстановки звездочка.
hostNameIncludeListstringРазделенный запятыми список имен хостов, которым разрешены входящие соединения в этой конечной точке. Имя хоста указывается без учета регистра и может начинаться с символа звездочка, используемого в качестве символа подстановки. Однако звездочку можно указывать не в любом месте имени хоста. Например, *.abc.com - допустимое имя хоста, а *.abc.* нет.
hostNameExcludeListstringРазделенный запятыми список имен хостов, которым не разрешены входящие соединения в этой конечной точке. Имя хоста указывается без учета регистра и может начинаться с символа звездочка, используемого в качестве символа подстановки. Однако звездочку можно указывать не в любом месте имени хоста. Например, *.abc.com - допустимое имя хоста, а *.abc.* нет.

httpEndpoint > accessLogging

Конфигурация протоколов доступа HTTP для конечной точки.

NameTypeDefaultDescription
enabledbooleantrueВключить ведение протокола доступа.
filePathПуть к файлу${server.output.dir}/logs/http_access.logПуть и имя файла протокола доступа. В пути к файлу можно использовать стандартные переменные подстановки, такие как ${server.output.dir}.
logFormatstring%h %u %{t}W "%r" %s %bЗадает формат протокола, в который заносится информации о доступе клиентов.
maxFileSizeint
Min: 0
20Максимальный размер файла протокола в мегабайтах. При его превышении создается новый файл. Нулевое значение указывает, что размер не ограничен.
maxFilesint
Min: 0
2Максимальное число файлов протокола. При его превышении заменяется самый старый файл. Нулевое значение указывает, что число не ограничено.

extraConfigProperties

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