pluginConfiguration - Wtyczka serwera WWW (pluginConfiguration)

Właściwości używane podczas generowania pliku konfiguracyjnego wtyczki serwera WWW

NameTypeDefaultDescription
pluginInstallRootstring/opt/IBM/WebSphere/PluginsMiejsce instalacji wtyczki serwera WWW w systemie plików hosta serwera WWW
webserverNamestringwebserver1Nazwa serwera WWW, w przypadku którego będzie używana ta konfiguracja. Używana podczas generowania położenia pliku dziennika wtyczki, jeśli nie zostanie jawnie podana nazwa pliku dziennika lub jego katalog.
webserverPortint
Min: -1

Max: 65535
80Port HTTP serwera WWW
webserverSecurePortint
Min: -1

Max: 65535
443Port HTTPS serwera WWW
sslKeyringLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.kdbPełna ścieżka do pliku kluczy SSL na hoście serwera WWW
sslStashfileLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.sthPełna ścieżka do pliku zeskładowanego SSL na hoście serwera WWW
sslCertlabelstringOkreśla etykietę certyfikatu w pliku kluczy, który będzie używany przez wtyczkę, gdy kontener WWW zażąda certyfikatu klienta z wtyczki.
ipv6PreferredbooleanfalseWartość używana podczas rozstrzygania nazwy hosta serwera aplikacji o wartości {null} lub {0}, przy czym preferowany jest ten typ adresu, o ile to możliwe
httpEndpointRefOdwołanie do elementu httpEndpoint najwyższego poziomu (łańcuch).defaultHttpEndpointOkreśl identyfikator punktu końcowego HTTP, który ma być uwzględniony w wygenerowanym pliku plugin-cfg.xml. Punkt końcowy definiuje serwer w klastrze. Wartość domyślna to defaultHttpEndpoint.
connectTimeoutOkres z dokładnością do sekundy5sOkreśla maksymalny czas, przez jaki serwer aplikacji powinien utrzymywać połączenie z serwerem WWW. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
serverIOTimeoutOkres z dokładnością do sekundy900sOkreśla maksymalny czas, przez jaki wtyczka serwera WWW oczekuje na wysłanie żądania lub otrzymanie odpowiedzi z serwera aplikacji. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
wsServerIOTimeoutOkres z dokładnością do sekundyOkreśla maksymalny czas, przez jaki wtyczka serwera WWW oczekuje na wysłanie żądania lub otrzymanie odpowiedzi gniazda WebSocket z serwera aplikacji. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
wsServerIdleTimeoutOkres z dokładnością do sekundyOkreśla maksymalny czas, przez jaki wtyczka serwera WWW oczekuje na zakończenie połączenia bezczynnego gniazda WebSocket. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
extendedHandshakebooleanfalseWartość true oznacza, że wtyczka serwera WWW używa rozszerzonego uzgadniania w celu sprawdzenia, czy serwer aplikacji działa.
waitForContinuebooleanfalseW przypadku wartości false (wartość domyślna), wtyczka serwera WWW wysyła nagłówek „Expect: 100-continue” z żądaniami HTTP, które zawierają treść komunikatu. Gdy wartość jest równa true, wtyczka serwera WWW wysyła nagłówek „Expect 100-continue:” z każdym żądaniem HTTP. Rozważ ustawienie tej wartości na true, jeśli między serwerem WWW a serwerem aplikacji znajduje się firewall i serwery te są wrażliwe na ponowienia żądań bez treści żądania.
logFileNameŚcieżka do plikuPełna ścieżka do pliku dziennika wtyczki serwera WWW. Komponent katalogu musi już istnieć. Dla serwerów WWW opartych na serwerze Apache ścieżka rozpoczynająca się znakiem potoku jest interpretowana jako zewnętrzny program rejestrujący. Jeśli ta ścieżka zostanie podana, zastąpi wartość właściwości logDirLocation.
logDirLocationŚcieżka do katalogu${pluginInstallRoot}/logs/${webserverName}Nieaktualne: Określa katalog, w którym znajduje się plik http_plugin.log. Patrz nazwa pliku dziennika.
serverIOTimeoutRetryint
Min: -1

Max: 65535
-1Ogranicza liczbę ponownych prób po przekroczeniu limitu czasu zapisy kub odczytu. Wartość domyślna (-1) nie powoduje zastosowania żadnych dodatkowych limitów, zatem liczba ponownych próby jest zawsze ograniczana przez liczbę dostępnych serwerów w klastrze. Wartość {0} wskazuje, że nie powinny być wykonywane żadne ponowne próby. Zasięgiem tej wartości jest klaster serwerów i nie ma ona zastosowania w przypadku niepowodzeń połączeń lub przekroczeń limitu czasu, których powodem jest wystąpienie przekroczenia limitu czasu wtyczki HTTP, ani przekroczeń limitu czasu gniazda WWW.
loadBalanceWeightint20Ta wartość jest dynamicznie zmieniana w czasie wykonywania. Waga serwera jest zmniejszana za każdym razem, gdy żądanie jest przypisywane do tego serwera. Gdy wagi wszystkich serwerów zmniejszą się do 0 lub niższej wartości, wtyczka serwera WWW ponownie dopasuje wszystkie wagi tak, aby były one większe niż 0.
serverRole
  • BACKUP
  • PRIMARY
PRIMARYRola serwera identyfikuje serwer jako serwer główny lub zapasowy. Gdy są dostępne serwery główne, wtyczka serwera WWW używa ich do równoważenia obciążenia i przełączania awaryjnego. Jeśli jednak nie jest dostępny żaden serwer główny, wtyczka serwera WWW używa tylko serwerów zapasowych do równoważenia obciążenia i przełączania awaryjnego.
BACKUP
Zapasowy
PRIMARY
Główny
ESIEnablebooleantrueWłaściwość ESIEnable umożliwia włączenie przetwarzania języka znaczników ESI (Edge Side Include) przy buforowaniu odpowiedzi. Ta właściwość zawiera opcję wyłączenia znaczników ESI w pliku konfiguracyjnym wtyczki serwera.
ESIMaxCacheSizeint1024Właściwość ESIMaxCacheSize wskazuje maksymalną wielkość pamięci podręcznej (domyślnie 1 MB). Ta właściwość zawiera opcję zastąpienia tej wartości w pliku konfiguracyjnym wtyczki serwera.
ESIInvalidationMonitorbooleanfalseWłaściwość ESIInvalidationMonitor określa, czy procesor ESI powinien odbierać unieważnienia od serwera aplikacji. Ta właściwość zawiera opcję zastąpienia tej wartości w pliku konfiguracyjnym wtyczki serwera.
ESIEnableToPassCookiesbooleanfalseWłaściwość ESIEnableToPassCookies umożliwia przekazywanie informacji cookie sesji do serwera WebSphere Application Server. Ta właściwość zawiera opcję zastąpienia tej wartości w pliku konfiguracyjnym wtyczki serwera.
trustedProxyEnablebooleanUmożliwia korzystanie z zaufanych serwerów proxy. Jeśli ta właściwość jest określona, zastępuje ona wartość w pliku konfiguracyjnym wtyczki serwera WWW.
trustedProxyGroupstringLista rozdzielonych przecinkami zaufanych serwerów proxy. Jeśli ta właściwość jest określona, zastępuje ona wartość w pliku konfiguracyjnym wtyczki serwera WWW.

httpEndpoint

Określ identyfikator punktu końcowego HTTP, który ma być uwzględniony w wygenerowanym pliku plugin-cfg.xml. Punkt końcowy definiuje serwer w klastrze. Wartość domyślna to defaultHttpEndpoint.

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARNDziałanie wykonywane po nieudanym uruchomieniu punktu końcowego.
IGNORE
Serwer nie będzie wysyłał żadnych ostrzeżeń ani komunikatów o błędach, gdy znajdzie błąd konfiguracji.
WARN
Serwer wyśle ostrzeżenie i komunikaty o błędach, gdy znajdzie błąd konfiguracji.
FAIL
Serwer wyśle ostrzeżenie lub komunikaty o błędach po pierwszym wystąpieniu błędu, a następnie serwer zostanie zatrzymany.
enabledbooleantruePrzełącz dostępność danego punktu końcowego. Wartość true oznacza, że dany punkt końcowy będzie aktywowany przez program rozsyłający do obsługi żądań HTTP.
hoststringlocalhostAdres IP, nazwa hosta serwera nazw domen (DNS) z przyrostkiem nazwy domeny lub po prostu nazwa hosta systemu DNS używana przez klient w żądaniach dotyczących zasobów. Użyj znaku gwiazdki (*) dla określenia wszystkich dostępnych interfejsów sieciowych.
httpPortint
Min: -1

Max: 65535
Port używany na potrzeby żądań HTTP klientów. Ustawienie wartości -1 umożliwia wyłączenie portu.
httpsPortint
Min: -1

Max: 65535
Port używany na potrzeby żądań HTTP klientów zabezpieczonych przy użyciu protokołu SSL (HTTPS). Ustawienie wartości -1 umożliwia wyłączenie portu.
httpOptionsRefOdwołanie do elementu httpOptions najwyższego poziomu (łańcuch).defaultHttpOptionsOpcje protokołu HTTP dla tego punktu końcowego.
sslOptionsRefOdwołanie do elementu sslOptions najwyższego poziomu (łańcuch).Opcje protokołu SSL dla tego punktu końcowego.
tcpOptionsRefOdwołanie do elementu tcpOptions najwyższego poziomu (łańcuch).defaultTCPOptionsOpcje protokołu TCP dla tego punktu końcowego.
accessLoggingRefOdwołanie do elementu httpAccessLogging najwyższego poziomu (łańcuch).Konfiguracja rejestrowania dostępu HTTP dla punktu końcowego.

httpEndpoint > httpOptions

Opcje protokołu HTTP dla tego punktu końcowego.

NameTypeDefaultDescription
keepAliveEnabledbooleantrueWłącza połączenia trwałe (utrzymywanie aktywności połączenia HTTP). Wartość true oznacza, że utrzymywana jest aktywność połączeń na potrzeby ponownego wykorzystania przez wiele sekwencyjnych żądań i odpowiedzi. Wartość false oznacza, że połączenia są zamykane po wysłaniu odpowiedzi.
maxKeepAliveRequestsint
Min: -1
100Maksymalna liczba trwałych żądań dozwolonych w ramach jednego połączenia HTTP, gdy włączone są połączenia trwałe. Wartość -1 oznacza nieograniczoną liczbę.
persistTimeoutOkres z dokładnością do sekundy30sCzas, przez który gniazdo może pozostać bezczynne między żądaniami. To ustawienie obowiązuje jedynie w przypadku włączenia połączeń trwałych. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
readTimeoutOkres z dokładnością do sekundy60sCzas oczekiwania na zakończenie żądania odczytu w gnieździe po wystąpieniu pierwszego odczytu. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
writeTimeoutOkres z dokładnością do sekundy60sCzas oczekiwania w gnieździe na przesłanie poszczególnych porcji danych odpowiedzi. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
removeServerHeaderbooleanfalseUsuwa informacje o implementacji serwera z nagłówków HTTP oraz wyłącza domyślną stronę powitania profilu Liberty.
NoCacheCookiesControlbooleantrueUmożliwia użytkownikowi wskazywanie, czy obecność nagłówka Set-Cookie powinna powodować aktualizowanie nagłówka Cache-Control przy użyciu wartości no-cache. To powoduje także dodanie nagłówka Expires.
AutoDecompressionbooleantrueWskazuje, czy kanał HTTP automatycznie dekompresuje dane treści żądania przychodzącego.

httpEndpoint > sslOptions

Opcje protokołu SSL dla tego punktu końcowego.

NameTypeDefaultDescription
sessionTimeoutOkres z dokładnością do sekundy1dCzas oczekiwania na zakończenie żądania odczytu lub zapisu w gnieździe. Ta wartość jest przesłaniana przez limity czasu specyficzne dla protokołu. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
suppressHandshakeErrorsbooleanfalseWyłącz rejestrowanie błędów uzgadniania SSL. Błędy uzgadniania SSL mogą występować w czasie normalnego działania, jednak komunikaty mogą być pomocne, jeśli protokół SSL zachowuje się w sposób nieoczekiwany.
sslRefOdwołanie do elementu ssl najwyższego poziomu (łańcuch).Domyślny repertuar konfiguracji SSL. Wartość domyślna to defaultSSLSettings.
sslSessionTimeoutOkres z dokładnością do milisekundy8640msLimit czasu sesji SSL, która jest nawiązana przez kanał SSL. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m), sekundy (s) lub milisekundy (ms). Na przykład określ 500 milisekund jako 500ms. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1s500ms oznacza 1,5 sekundy.

httpEndpoint > tcpOptions

Opcje protokołu TCP dla tego punktu końcowego.

NameTypeDefaultDescription
inactivityTimeoutOkres z dokładnością do milisekundy60sCzas oczekiwania na zakończenie żądania odczytu lub zapisu w gnieździe. Ta wartość jest przesłaniana przez limity czasu specyficzne dla protokołu. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m), sekundy (s) lub milisekundy (ms). Na przykład określ 500 milisekund jako 500ms. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1s500ms oznacza 1,5 sekundy.
soReuseAddrbooleantrueWłącza natychmiastowe ponowne powiązanie z portem bez aktywnego programu nasłuchującego.
addressIncludeListstringRozdzielana przecinkami lista adresów, które mogą nawiązywać połączenia przychodzące w tym punkcie końcowym. Można podać adres IPv4 lub IPv6. Wszystkie wartości w adresach typu IPv4 lub IPv6 muszą być reprezentowane przez liczbę lub znak wieloznaczny w postaci gwiazdki.
addressExcludeListstringRozdzielana przecinkami lista adresów, które nie mogą nawiązywać połączeń przychodzących w tym punkcie końcowym. Można podać adres IPv4 lub IPv6. Wszystkie wartości w adresach typu IPv4 lub IPv6 muszą być reprezentowane przez liczbę lub znak wieloznaczny w postaci gwiazdki.
hostNameIncludeListstringRozdzielana przecinkami lista nazw hostów, które mogą nawiązywać połączenia przychodzące w tym punkcie końcowym. Nazwy hostów mogą zaczynać się od gwiazdki (używanej jako znak wieloznaczny) i nie jest w nich rozróżniana wielkość liter. Jednak gwiazdki nie mogą występować w dowolnym miejscu nazwy hosta. Na przykład nazwa *.abc.com jest poprawna, ale nazwa *.abc.* jest niepoprawna.
hostNameExcludeListstringRozdzielana przecinkami lista nazw hostów, które nie mogą nawiązywać połączeń przychodzących w tym punkcie końcowym. Nazwy hostów mogą zaczynać się od gwiazdki (używanej jako znak wieloznaczny) i nie jest w nich rozróżniana wielkość liter. Jednak gwiazdki nie mogą występować w dowolnym miejscu nazwy hosta. Na przykład nazwa *.abc.com jest poprawna, ale nazwa *.abc.* jest niepoprawna.

httpEndpoint > accessLogging

Konfiguracja rejestrowania dostępu HTTP dla punktu końcowego.

NameTypeDefaultDescription
enabledbooleantrueWłącza rejestrowanie dostępu.
filePathŚcieżka do pliku${server.output.dir}/logs/http_access.logŚcieżka do katalogu i nazwa pliku dziennika dostępu. Określając ścieżkę do katalogu, można stosować standardowe podstawianie zmiennych, na przykład ${katalog.wyjściowy.serwera}.
logFormatstring%h %u %{t}W "%r" %s %bOkreśla format dziennika stosowany przy rejestrowaniu informacji o dostępie klientów.
maxFileSizeint
Min: 0
20Maksymalna wielkość (w megabajtach) pliku dziennika przed jego zastąpieniem. Wartość 0 oznacza brak limitu.
maxFilesint
Min: 0
2Maksymalna liczba przechowywanych plików dziennika, zanim najstarszy plik zostaje usunięty. Wartość 0 oznacza brak limitu.

extraConfigProperties

Właściwości dodatkowe, które mają zostać dodane do elementu Config w wygenerowanym pliku konfiguracyjnym wtyczki. Te właściwości mogą zostać podane przez dział wsparcia IBM w celu modyfikacji zachowania wtyczki serwera WWW.