Właściwości używane podczas generowania pliku konfiguracyjnego wtyczki serwera WWW
Name | Type | Default | Description |
---|---|---|---|
pluginInstallRoot | string | /opt/IBM/WebSphere/Plugins | Miejsce instalacji wtyczki serwera WWW w systemie plików hosta serwera WWW |
webserverName | string | webserver1 | Nazwa 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. |
webserverPort | int Min: -1 Max: 65535 | 80 | Port HTTP serwera WWW |
webserverSecurePort | int Min: -1 Max: 65535 | 443 | Port HTTPS serwera WWW |
sslKeyringLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | Pełna ścieżka do pliku kluczy SSL na hoście serwera WWW |
sslStashfileLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | Pełna ścieżka do pliku zeskładowanego SSL na hoście serwera WWW |
sslCertlabel | string | Określa etykietę certyfikatu w pliku kluczy, który będzie używany przez wtyczkę, gdy kontener WWW zażąda certyfikatu klienta z wtyczki. | |
ipv6Preferred | boolean | false | Wartość 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 |
httpEndpointRef | Odwołanie do elementu httpEndpoint najwyższego poziomu (łańcuch). | defaultHttpEndpoint | 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. |
connectTimeout | Okres z dokładnością do sekundy | 5s | Okreś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. |
serverIOTimeout | Okres z dokładnością do sekundy | 900s | Okreś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. |
wsServerIOTimeout | Okres z dokładnością do sekundy | Okreś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. | |
wsServerIdleTimeout | Okres z dokładnością do sekundy | Okreś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. | |
extendedHandshake | boolean | false | Wartość true oznacza, że wtyczka serwera WWW używa rozszerzonego uzgadniania w celu sprawdzenia, czy serwer aplikacji działa. |
waitForContinue | boolean | false | W 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 pliku | Peł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. |
serverIOTimeoutRetry | int Min: -1 Max: 65535 | -1 | Ogranicza 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. |
loadBalanceWeight | int | 20 | Ta 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 |
| PRIMARY | Rola 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 |
ESIEnable | boolean | true | Wł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. |
ESIMaxCacheSize | int | 1024 | Wł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. |
ESIInvalidationMonitor | boolean | false | Wł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. |
ESIEnableToPassCookies | boolean | false | Wł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. |
trustedProxyEnable | boolean | Umoż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. | |
trustedProxyGroup | string | Lista 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. |
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.
Name | Type | Default | Description |
---|---|---|---|
onError |
| WARN | Dział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. |
enabled | boolean | true | Przełą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. |
host | string | localhost | Adres 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. |
httpPort | int Min: -1 Max: 65535 | Port używany na potrzeby żądań HTTP klientów. Ustawienie wartości -1 umożliwia wyłączenie portu. | |
httpsPort | int 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. | |
httpOptionsRef | Odwołanie do elementu httpOptions najwyższego poziomu (łańcuch). | defaultHttpOptions | Opcje protokołu HTTP dla tego punktu końcowego. |
sslOptionsRef | Odwołanie do elementu sslOptions najwyższego poziomu (łańcuch). | Opcje protokołu SSL dla tego punktu końcowego. | |
tcpOptionsRef | Odwołanie do elementu tcpOptions najwyższego poziomu (łańcuch). | defaultTCPOptions | Opcje protokołu TCP dla tego punktu końcowego. |
accessLoggingRef | Odwołanie do elementu httpAccessLogging najwyższego poziomu (łańcuch). | Konfiguracja rejestrowania dostępu HTTP dla punktu końcowego. |
Opcje protokołu HTTP dla tego punktu końcowego.
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | boolean | true | Włą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. |
maxKeepAliveRequests | int Min: -1 | 100 | Maksymalna liczba trwałych żądań dozwolonych w ramach jednego połączenia HTTP, gdy włączone są połączenia trwałe. Wartość -1 oznacza nieograniczoną liczbę. |
persistTimeout | Okres z dokładnością do sekundy | 30s | Czas, 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. |
readTimeout | Okres z dokładnością do sekundy | 60s | Czas 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. |
writeTimeout | Okres z dokładnością do sekundy | 60s | Czas 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. |
removeServerHeader | boolean | false | Usuwa informacje o implementacji serwera z nagłówków HTTP oraz wyłącza domyślną stronę powitania profilu Liberty. |
NoCacheCookiesControl | boolean | true | Umoż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. |
AutoDecompression | boolean | true | Wskazuje, czy kanał HTTP automatycznie dekompresuje dane treści żądania przychodzącego. |
Opcje protokołu SSL dla tego punktu końcowego.
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | Okres z dokładnością do sekundy | 1d | Czas 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. |
suppressHandshakeErrors | boolean | false | Wyłą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. |
sslRef | Odwołanie do elementu ssl najwyższego poziomu (łańcuch). | Domyślny repertuar konfiguracji SSL. Wartość domyślna to defaultSSLSettings. | |
sslSessionTimeout | Okres z dokładnością do milisekundy | 8640ms | Limit 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. |
Opcje protokołu TCP dla tego punktu końcowego.
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | Okres z dokładnością do milisekundy | 60s | Czas 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. |
soReuseAddr | boolean | true | Włącza natychmiastowe ponowne powiązanie z portem bez aktywnego programu nasłuchującego. |
addressIncludeList | string | Rozdzielana 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. | |
addressExcludeList | string | Rozdzielana 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. | |
hostNameIncludeList | string | Rozdzielana 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. | |
hostNameExcludeList | string | Rozdzielana 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. |
Konfiguracja rejestrowania dostępu HTTP dla punktu końcowego.
Name | Type | Default | Description |
---|---|---|---|
enabled | boolean | true | Włą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}. |
logFormat | string | %h %u %{t}W "%r" %s %b | Określa format dziennika stosowany przy rejestrowaniu informacji o dostępie klientów. |
maxFileSize | int Min: 0 | 20 | Maksymalna wielkość (w megabajtach) pliku dziennika przed jego zastąpieniem. Wartość 0 oznacza brak limitu. |
maxFiles | int Min: 0 | 2 | Maksymalna liczba przechowywanych plików dziennika, zanim najstarszy plik zostaje usunięty. Wartość 0 oznacza brak limitu. |
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.