Свойства, применяемые при создании файла конфигурации модуля веб-сервера
Name | Type | Default | Description |
---|---|---|---|
pluginInstallRoot | string | /opt/IBM/WebSphere/Plugins | Установочное расположение модуля веб-сервера в файловой системе хоста веб-сервера |
webserverName | string | webserver1 | Имя целевого веб-сервера для применения этой конфигурации. Применяется для создания расположения файла протокола модуля, если оно не указано с помощью параметров Имя файла протокола или Каталог файла протокола. |
webserverPort | int Min: -1 Max: 65535 | 80 | Порт HTTP веб-сервера |
webserverSecurePort | int Min: -1 Max: 65535 | 443 | Порт HTTPS веб-сервера |
sslKeyringLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | Полный путь к файлу набора ключей SSL на хосте веб-сервера |
sslStashfileLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | Полный путь к файлу паролей SSL на хосте веб-сервера |
sslCertlabel | string | Задает метку свойства в наборе ключей, применяемую модулем при запросе сертификата клиента веб-контейнером. | |
ipv6Preferred | boolean | false | Применяется при обработке имени хоста сервера приложений {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 сек. | |
extendedHandshake | boolean | false | При значении true модуль веб-сервера использует расширенную процедуру согласования, чтобы определить, работает ли сервер приложений. |
waitForContinue | boolean | false | При значении false (по умолчанию) модуль веб-сервера отправляет заголовок "Expect: 100-continue" в запросах HTTP с телом сообщения. При значении true модуль веб-сервера отправляет заголовок "Expect: 100-continue" с каждым запросом HTTP. Используйте значение true, если между веб-сервером и сервером приложений находится брандмауэр и они чувствительны к запросам без тела запроса. |
logFileName | Путь к файлу | Полный путь к файлу протокола модуля веб-сервера. Компонент каталога должен уже существовать. Для веб-серверов Apache символ вертикальной черты в начале пути интерпретируется как внешняя конвейерная программа ведения протокола. Если значение указано, то путь переопределяет logDirLocation. | |
logDirLocation | Путь к каталогу | ${pluginInstallRoot}/logs/${webserverName} | Устарело: каталог, в котором находится файл http_plugin.log. См. Имя файла протокола. |
serverIOTimeoutRetry | int Min: -1 Max: 65535 | -1 | Ограничивает число повторных запросов после тайм-аута чтения или записи. Значение по умолчанию {-1} не накладывает дополнительные ограничения; число повторных попыток ограничено числом доступных серверов в кластере. Значение {0} позволяет запретить повторные попытки. Это значение действует на уровне кластера сервера и не применяется к ошибкам соединений и тайм-аутам соединений модуля HTTP или тайм-аутам веб-сокетов. |
loadBalanceWeight | int | 20 | Это значение динамически изменяется во время работы. Весовой коэффициент сервера снижается при каждом назначении запроса этому серверу. Если все весовые коэффициенты для всех серверов снижаются до 0 или ниже, то модуль веб-сервера переназначает все весовые коэффициенты до положительных значений. |
serverRole |
| PRIMARY | Роль сервера определяет сервер как основной или резервный. Если основные серверы доступны, то модуль веб-сервера использует их для распределения нагрузки и автоматического переключения при сбое. Однако при отсутствии всех основных серверов модуль веб-сервера использует для распределения нагрузки и автоматического переключения при сбое только резервные серверы. BACKUP Резервный PRIMARY Основной |
ESIEnable | boolean | true | Свойство ESIEnable включает поддержку Edge Side Include для кэширования ответов. Это свойство предоставляет возможность выключить ESI в файле конфигурации модуля веб-сервера. |
ESIMaxCacheSize | int | 1024 | ESIMaxCacheSize задает максимальный размер кэша, который по умолчанию равен 1 МБ. Это свойство позволяет переопределить значение в файле конфигурации модуля веб-сервера. |
ESIInvalidationMonitor | boolean | false | ESIInvalidationMonitor указывает, должен ли обработчик ESI получать аннулирования от сервера приложений. Это свойство позволяет переопределить значение в файле конфигурации модуля веб-сервера. |
ESIEnableToPassCookies | boolean | false | ESIEnableToPassCookies обеспечивает возможность пересылать сеансовые cookie серверу WebSphere Application Server. Это свойство позволяет переопределить значение в файле конфигурации модуля веб-сервера. |
trustedProxyEnable | boolean | Разрешает применение доверенных прокси-серверов. Это свойство переопределяет значение в файле конфигурации модуля веб-сервера. | |
trustedProxyGroup | string | Список доверенных прокси-серверов через запятую. Это свойство переопределяет значение в файле конфигурации модуля веб-сервера. |
Укажите идентификатор для конечной точки http для включения в созданный файл plugin-cfg.xml. Конечная точка определяет сервер в кластере. Значение по умолчанию: 'defaultHttpEndpoint'.
Name | Type | Default | Description |
---|---|---|---|
onError |
| WARN | Действие при сбое во время запуска конечной точки. IGNORE Сервер не будет выдавать предупреждения и сообщения об ошибках при обнаружении ошибки конфигурации. WARN Сервер будет выдавать предупреждения и сообщения об ошибках при обнаружении ошибки конфигурации. FAIL Сервер выдаст предупреждение или сообщение об ошибке при первом возникновении ошибки и остановится. |
enabled | boolean | true | Позволяет сделать конечную точку доступной или недоступной. Если значение равно true, то конечная точка активируется диспетчером для обработки запросов HTTP. |
host | string | localhost | IP-адрес, полное доменное имя хоста или краткое имя хоста, применяемые клиентом для запроса ресурса. Для выбора всех доступных сетевых интерфейсов укажите '*'. |
httpPort | int Min: -1 Max: 65535 | Номер порта для запросов HTTP клиента. Для выключения порта укажите значение -1. | |
httpsPort | int Min: -1 Max: 65535 | Порт для запросов HTTP клиента, защищенных с помощью SSL (https). Для выключения порта укажите значение -1. | |
httpOptionsRef | Ссылка на элемент httpOptions верхнего уровня (строка). | defaultHttpOptions | Параметры протокола HTTP для конечной точки. |
sslOptionsRef | Ссылка на элемент sslOptions верхнего уровня (строка). | Параметры протокола SSL для конечной точки. | |
tcpOptionsRef | Ссылка на элемент tcpOptions верхнего уровня (строка). | defaultTCPOptions | Параметры протокола TCP для конечной точки. |
accessLoggingRef | Ссылка на элемент httpAccessLogging верхнего уровня (строка). | Конфигурация протоколов доступа HTTP для конечной точки. |
Параметры протокола HTTP для конечной точки.
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | boolean | true | Разрешает применять поддерживаемые соединения (HTTP keepalive). Если значение равно true, соединение сохраняется активным для передачи нескольких последовательных запросов и ответов. Если значение равно false, соединение закрывается сразу после отправки ответа. |
maxKeepAliveRequests | int 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 сек. |
removeServerHeader | boolean | false | Удаляет информацию о реализации сервера из заголовков HTTP, а также выключает страницу приветствия профайла Liberty по умолчанию. |
NoCacheCookiesControl | boolean | true | Позволяет пользователю указать, приводит ли наличие заголовка Set-Cookie к обновлению заголовка Cache-Control с использованием соответствующего значения no-cache. При этом также добавляется заголовок Expires. |
AutoDecompression | boolean | true | Управляет автоматическим развертыванием данных тела входящего запроса в канале HTTP. |
Параметры протокола SSL для конечной точки.
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | Период (с точностью до секунды) | 1d | Время, в течение которого следует ждать завершения операции чтения или записи через сокет. Это значение переопределяется тайм-аутом, заданным на уровне протокола. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек. |
suppressHandshakeErrors | boolean | false | Отключить протоколирование ошибок процедуры согласования SSL. Ошибки процедуры согласования SSL могут возникать во время нормальной работы, но эти сообщения могут быть полезны в случае неполадок SSL. |
sslRef | Ссылка на элемент ssl верхнего уровня (строка). | Набор конфигураций SSL по умолчанию. Значение по умолчанию: defaultSSLSettings. | |
sslSessionTimeout | Период (с точностью до миллисекунды) | 8640ms | Предельное значение тайм-аута для сеанса SSL в канале SSL. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m), секунды (s) или миллисекунды (ms). Например, укажите 500 миллисекунд как 500ms. Одна запись может включать несколько значений. Так, 1s500ms равно 1,5 сек. |
Параметры протокола TCP для конечной точки.
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | Период (с точностью до миллисекунды) | 60s | Время, в течение которого следует ждать завершения операции чтения или записи через сокет. Это значение переопределяется тайм-аутом, заданным на уровне протокола. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m), секунды (s) или миллисекунды (ms). Например, укажите 500 миллисекунд как 500ms. Одна запись может включать несколько значений. Так, 1s500ms равно 1,5 сек. |
soReuseAddr | boolean | true | Допускает немедленное повторное связывание с портом при отсутствии активного получателя запросов. |
addressIncludeList | string | Разделенный запятыми список адресов, которым разрешены входящие соединения в этой конечной точке. Можно указать адреса IPv4 или IPv6. Все значения в адресе IPv4 или IPv6 должны задаваться числом или символом подстановки звездочка. | |
addressExcludeList | string | Разделенный запятыми список адресов, которым не разрешены входящие соединения в этой конечной точке. Можно указать адреса IPv4 или IPv6. Все значения в адресе IPv4 или IPv6 должны задаваться числом или символом подстановки звездочка. | |
hostNameIncludeList | string | Разделенный запятыми список имен хостов, которым разрешены входящие соединения в этой конечной точке. Имя хоста указывается без учета регистра и может начинаться с символа звездочка, используемого в качестве символа подстановки. Однако звездочку можно указывать не в любом месте имени хоста. Например, *.abc.com - допустимое имя хоста, а *.abc.* нет. | |
hostNameExcludeList | string | Разделенный запятыми список имен хостов, которым не разрешены входящие соединения в этой конечной точке. Имя хоста указывается без учета регистра и может начинаться с символа звездочка, используемого в качестве символа подстановки. Однако звездочку можно указывать не в любом месте имени хоста. Например, *.abc.com - допустимое имя хоста, а *.abc.* нет. |
Конфигурация протоколов доступа HTTP для конечной точки.
Name | Type | Default | Description |
---|---|---|---|
enabled | boolean | true | Включить ведение протокола доступа. |
filePath | Путь к файлу | ${server.output.dir}/logs/http_access.log | Путь и имя файла протокола доступа. В пути к файлу можно использовать стандартные переменные подстановки, такие как ${server.output.dir}. |
logFormat | string | %h %u %{t}W "%r" %s %b | Задает формат протокола, в который заносится информации о доступе клиентов. |
maxFileSize | int Min: 0 | 20 | Максимальный размер файла протокола в мегабайтах. При его превышении создается новый файл. Нулевое значение указывает, что размер не ограничен. |
maxFiles | int Min: 0 | 2 | Максимальное число файлов протокола. При его превышении заменяется самый старый файл. Нулевое значение указывает, что число не ограничено. |
Дополнительные свойства, добавляемые в элемент Config в создаваемом файле конфигурации модуля. Эти свойства могут быть указаны службой поддержки IBM для изменения поведения модуля веб-сервера.