Właściwości wtyczki serwera WWW

Ta strona umożliwia wyświetlanie lub zmianę ustawień pliku konfiguracyjnego wtyczki serwera WWW. Plik konfiguracyjny wtyczki, plugin_cfg.xml, zawiera właściwości umożliwiające nawiązanie komunikacji między serwerem WWW a serwerem aplikacji.

Aby wyświetlić tę stronę Konsoli administracyjnej, należy kliknąć opcję Serwery > Typy serwerów > Serwery WWW > nazwa_serwera_WWW > Właściwości wtyczki.

Karta Konfiguracja umożliwia edycję pól. Karta Środowisko wykonawcze umożliwia wyświetlanie informacji tylko do odczytu.

Karta Środowisko wykonawcze jest dostępna tylko wówczas, gdy serwer WWW uzyskał dostęp do aplikacji działających na serwerach aplikacji i istnieje plik http_plugin.log.

Ignoruj niepowodzenia DNS podczas uruchomienia serwera WWW

Określa, czy wtyczka ignoruje niepowodzenia DNS w ramach konfiguracji przy uruchamianiu.

Pole to odpowiada elementowi IgnoreDNSFailures w pliku plugin-cfg.xml.

Po ustawieniu na wartość true wtyczka ignoruje niepowodzenia DNS w ramach konfiguracji i jest pomyślnie uruchamiana, jeśli co najmniej jeden serwer w poszczególnych klastrach serwerów może rozstrzygnąć nazwę hosta. Każdy serwer, którego nazwy hosta nie można rozstrzygnąć, jest oznaczony jako niedostępny przez cały czas obowiązywania konfiguracji. W późniejszym czasie, podczas kierowania żądań, nie są podejmowane próby rozstrzygnięcia nazwy hosta. W razie wystąpienia niepowodzenia DNS w pliku dziennika zostaje zapisany komunikat i inicjacja wtyczki jest kontynuowana, zamiast uniemożliwienia uruchomienia serwera WWW. Po określeniu wartości false niepowodzenia DNS uniemożliwiają uruchomienie serwera WWW.

Typ danych String
Wartość domyślna fałsz
Odstęp czasu między operacjami odświeżania konfiguracji

Określa odstęp czasu (w sekundach) sprawdzania przez wtyczkę pliku konfiguracyjnego, czy dokonane zostały aktualizacje. Wtyczka sprawdza plik pod kątem modyfikacji, które zostały dokonane od czasu załadowania konfiguracji wtyczki.

W środowisku programistycznym, w którym zmiany są często dokonywane, preferowane jest ustawienie wartości niższej niż ustawienie domyślne 60 sekund. W środowisku produkcyjnym preferowana jest wartość wyższa niż domyślna, gdyż aktualizacje konfiguracji nie zachodzą tak często. Jeśli przeładowanie wtyczki z jakiegoś powodu nie powiedzie się, w jej pliku dziennika zapisany zostaje komunikat i do momentu pomyślnego przeładowania pliku konfiguracyjnego wtyczki używana jest poprzednia konfiguracja. Jeśli zmiany w konfiguracji wtyczki nie są widoczne, należy sprawdzić jej plik dziennika w celu znalezienia przyczyny problemu.

Typ danych Integer
Wartość domyślna 60 sekund
Nazwa pliku konfiguracyjnego wtyczki

Określa nazwę pliku konfiguracyjnego wtyczki. Serwer aplikacji domyślnie generuje plik plugin-cfg.xml. Plik konfiguracyjny identyfikuje aplikacje, serwery aplikacji, klastry i porty HTTP serwera WWW. Serwer WWW używa tego pliku przy uzyskiwaniu dostępu do aplikacji wdrożonych na różnych serwerach aplikacji.

Uwaga: Pole Nazwa pliku konfiguracyjnego wtyczki jest wyłączone i nie można go zmienić. Jest ono wyświetlane tylko w celach informacyjnych.

Jeśli wymagane jest inne położenie, należy ponownie uruchomić instalator wtyczki w celu zdefiniowania innego położenia, a następnie uruchomić nowy skrypt configureWebserver utworzony w procesie instalowania na komputerze serwera WebSphere Application Server.

Jeśli wtyczka serwera WWW zostanie wybrana podczas instalacji, program instalacyjny konfiguruje serwer WWW do identyfikowania położenia i nazwy pliku plugin-cfg.xml, jeśli jest to możliwe. Plik konfiguracyjny wtyczki jest domyślnie instalowany w katalogu katalog_główny_wtyczki/config/nazwa_serwera_WWW.

Program instalacyjny dodaje do konfiguracji serwera WWW dyrektywę określającą położenie pliku plugin-cfg.xml.

W przypadku zdalnych serwerów WWW należy skopiować ten plik z katalogu lokalnego, w którym zainstalowany jest serwer aplikacji, na zdalny komputer. Jest to określane jako propagowanie pliku konfiguracyjnego. Jeśli jako serwer WWW używany jest serwer IBM HTTP Server w wersji 6.1 lub nowszej, serwer WebSphere Application Server może automatycznie propagować plik konfiguracyjny wtyczki do komputerów zdalnych, pod warunkiem że na potrzeby propagowania pliku istnieje działający mechanizm transportu HTTP.

Klikając przycisk Wyświetl, można wyświetlić kopię bieżącego pliku konfiguracyjnego wtyczki.

Typ danych String
Wartość domyślna plugin-cfg.xml
Automatycznie generuj plik konfiguracyjny wtyczki
Aby plik konfiguracyjny wtyczki był generowany automatycznie wygenerować dla zdalnego serwera WWW:
  • To pole musi być zaznaczone.
  • Usługa konfiguracji wtyczki musi być włączona.
Jeśli uruchomiono usługę konfiguracji wtyczki, plik konfiguracji jest automatycznie tworzony dla serwera za każdym razem, gdy:
  • Administrator serwera WebSphere Application Server definiuje nowy serwer WWW.
  • Aplikacja jest wdrażana na serwerze aplikacji.
  • Aplikacja została zdeinstalowana.
  • Zaktualizowano i zapisano definicję hosta wirtualnego.

Domyślnie pole to jest zaznaczone. Usuń zaznaczenie pola wyboru, aby ręcznie wygenerować plik konfiguracyjny wtyczki dla danego serwera WWW.

[AIX Solaris HP-UX Linux Windows] Ważne: Plik konfiguracyjny wygenerowany po raz pierwszy nie zawiera hosta admin_host na liście hostów wirtualnych. W artykule "Zezwalanie na dostęp serwerów WWW do Konsoli administracyjnej" opisano sposób dodawania hosta admin_host do listy hostów wirtualnych.
Automatycznie propaguj plik konfiguracyjny wtyczki
Określa, czy serwer aplikacji ma automatycznie propagować kopię zmienionego pliku konfiguracyjnego do serwera WWW:
  • To pole musi być zaznaczone.
  • Usługa konfiguracji wtyczki musi być włączona.
  • W środowisku menedżera wdrażania agent węzła serwera WebSphere Application Server musi istnieć w węźle pełniącym rolę hosta dla serwera WWW powiązanego ze zmienionym plikiem konfiguracyjnym wtyczki.
Domyślnie pole to jest zaznaczone.
Uwaga: Plik konfiguracyjny wtyczki może być automatycznie propagowany na zdalny serwer WWW tylko wówczas, jeśli jest to serwer WWW IBM HTTP Server w wersji 6.1 lub nowszej, a jego serwer administracyjny jest uruchomiony.

Ponieważ usługa konfiguracji wtyczki działa w tle i nie jest powiązana z Konsolą administracyjną, w konsoli nie mogą być wyświetlane wyniki automatycznego propagowania.

[AIX Solaris HP-UX Linux Windows] W przypadku platform rozproszonych można sprawdzić odpowiednie komunikaty w pliku SystemOut.log menedżera wdrażania w celu potwierdzenia, że automatyczna propagacja została zakończona pomyślnie.

[z/OS] W przypadku platformy z/OS można sprawdzić odpowiednie komunikaty w dzienniku TSO JOB w celu potwierdzenia, że automatyczna propagacja została zakończona pomyślnie.

Nazwa pliku kluczy wtyczki
Określa pełną ścieżkę katalogu i nazwę pliku bazy danych zawierającego pliki kluczy zabezpieczających używane przez wtyczkę serwera WWW dla żądań HTTPS. Plik taki rezyduje na serwerze WWW powiązanym z tą wtyczką serwera WWW. Po określeniu pełnej ścieżki katalogu i nazwy pliku bazy danych można:
  • Kliknąć opcję Zarządzaj kluczami i certyfikatami w celu zaktualizowania pliku.
  • Kliknąć opcję Kopiuj do katalogu pliku kluczy serwera WWW w celu dodania kopii tego pliku do katalogu pliku kluczy serwera WWW.
Typ danych String
Wartość domyślna Brak
Nazwa pliku i katalogu konfiguracyjnego wtyczki

Określa pełną ścieżkę do kopii serwera WWW pliku konfiguracyjnego wtyczki serwera WWW. Ścieżka składa się z nazwy pliku i jego położenia na komputerze, na którym jest uruchomiony serwer WWW.

Nazwa pliku i katalogu pliku kluczy wtyczki

Określa pełną ścieżkę do kopii serwera WWW pliku bazy danych zawierającego pliki kluczy zabezpieczeń. Ścieżka składa się z nazwy pliku i jego położenia na komputerze, na którym jest uruchomiony serwer WWW.

Rejestrowanie informacji dla wtyczki

Określa położenie i nazwę pliku http_plugin.log. Określa także zakres komunikatów zapisanych w dzienniku.

Dziennik określa położenie i poziom komunikatów zapisywanych w dzienniku przez wtyczkę. Jeśli dziennik nie zostanie określony w pliku konfiguracyjnym, w niektórych przypadkach komunikaty dziennika są zapisywane w dzienniku błędów serwera WWW.

Jeśli na platformie rozproszonej plik dziennika nie istnieje, zostanie utworzony. Jeśli plik dziennika już istnieje, zostanie otwarty w trybie dodawania, z zachowaniem poprzednich komunikatów dziennika.

Nazwa pliku dziennika - pełna ścieżka do pliku dziennika, w którym wtyczka zapisuje komunikaty o błędach.

Typ danych String
Wartość domyślna katalog_główny_wtyczek/logs/nazwa_serwera_WWW/http_plugin.log

Określ ścieżkę do pliku http_plugin.log.

Poziom rejestrowania- poziom szczegółów komunikatów dziennika zapisywanych w dzienniku przez wtyczkę. Dla tego atrybutu można określić jedną z następujących wartości:
  • Śledzenie. Wszystkie kroki procesu żądania są szczegółowo rejestrowane.
  • Statystyki. Rejestrowane są informacje o serwerze wybranym dla każdego żądania i inne informacje dotyczące równoważenia obciążenia dotyczące obsługi żądań.
  • Ostrzeżenie. Rejestrowane są wszystkie komunikaty ostrzegawcze i komunikaty o błędach związane z nieprawidłowym przetwarzaniem żądań.
  • Błąd. Rejestrowane są tylko komunikaty o błędach związane z nieprawidłowym przetwarzaniem żądań.
  • Debugowanie. Rejestrowane są wszystkie newralgiczne kroki wykonywane przy przetwarzaniu żądań.
  • Szczegóły. Rejestrowane są wszystkie informacje dotyczące żądań i odpowiedzi.

Jeśli poziom rejestrowania nie jest określony, użyta zostaje domyślna wartość Błąd.

Ustawiając poziom na wartość Śledzenie, należy zachować ostrożność. Przy tym poziomie rejestrowana jest duża liczba komunikatów, co może spowodować bardzo szybkie zapełnienie miejsca na dysku/systemu plików. Nie należy używać ustawienia Śledzenie w normalnie funkcjonującym środowisku, gdyż pogarsza ono wydajność.

[AIX Solaris HP-UX Linux Windows] [iSeries] [z/OS] Ważne: Jeśli serwer WWW i jego wtyczka działają w systemach AIX, HP-UX, Linux lub Solaris oraz zmieniono poziom rejestrowania w pliku plugin-cfg.xml, zmiana taka nie będzie uwzględniana automatycznie. Aby została uwzględniona, należy zrestartować serwer WWW. Na przykład w przypadku systemu Solaris jeśli serwer WWW nie zostanie zrestartowany, do pliku katalog_główny_wtyczek/logs/http_plugin.log zostanie wprowadzony komunikat o błędzie o następującej treści:
BŁĄD: ws_config_parser:handleLogEnd: Nie można otworzyć pliku dziennika 
'/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
Typ danych String
Wartość domyślna Błąd



Zaznaczone odsyłacze (online) wymagają dostępu do Internetu.

Zadania pokrewne
Odsyłacze pokrewne
Właściwości optymalizacji żądań i odpowiedzi wtyczki serwera WWW
Właściwości buforowania wtyczki serwera WWW
Właściwości routingu żądań wtyczki serwera WWW


Nazwa pliku: uwsv_plugin_props.html