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.

Uwaga: Ten temat odwołuje się do co najmniej jednego pliku dziennika serwera aplikacji. Zalecanym rozwiązaniem alternatywnym w systemach rozproszonych oraz w systemach IBM® i jest skonfigurowanie serwera tak, aby korzystał z infrastruktury rejestrowania i śledzenia HPEL (High Performance Extensible Logging), a nie z plików SystemOut.log, SystemErr.log, trace.log i activity.log. Ponadto można korzystać z rejestrowania HPEL w połączeniu z rodzimymi narzędziami do rejestrowania systemu z/OS. W przypadku korzystania z dziennika HPEL można uzyskać dostęp do wszystkich informacji dziennika i śledzenia, używając z poziomu katalogu bin profilu serwera narzędzia wiersza komend LogViewer. Więcej informacji na temat korzystania z dziennika HPEL zawiera sekcja dotycząca używania dziennika HPEL do rozwiązywania problemów z aplikacjami.

Ignoruj błędy serwera DNS przy uruchamianiu 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 wartości 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. Jeśli nie można rozstrzygnąć nazwy hosta serwera, jest on oznaczany jako niedostępny w konfiguracji. Podczas kierowania żądań nie są podejmowane dalsze próby rozstrzygnięcia nazwy hosta. W razie wystąpienia niepowodzenia DNS w pliku dziennika wtyczki zostanie zapisany komunikat, a następnie proces inicjowania wtyczki będzie kontynuowany.

Jeśli wartością jest false, domyślnie niepowodzenia DNS spowodują niezainicjowanie wtyczki i niepowodzenie żądań. Jednak serwer WWW zostanie uruchomiony.

Informacje	Wartość
Typ danych	Łańcuch
Wartość domyślna	false

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.

Informacje	Wartość
Typ danych	Liczba całkowita
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.

Unikanie problemów: Pole to jest wyłączone i nie można go zmienić. Wartość jest wyświetlana tylko w celach informacyjnych.gotcha

Jeśli wymagane jest inne położenie, należy ponownie uruchomić narzędzie konfiguracji wtyczek w celu zdefiniowania nowego 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 jest zainstalowany 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.

Informacje	Wartość
Typ danych	Łańcuch
Wartość domyślna	plugin-cfg.xml

Automatycznie generuj plik konfiguracyjny wtyczki

Aby plik konfiguracyjny wtyczki był generowany automatycznie dla zdalnego serwera WWW:

To pole musi być zaznaczone.
Usługa konfiguracji wtyczki musi być włączona.

Jeśli włączono usługę konfiguracji wtyczki, jej plik konfiguracyjny jest automatycznie tworzony dla serwera WWW 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.

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" znajdującym się w Centrum informacyjnym 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. Taki plik znajduje się 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 magazynu kluczy serwera WWW w celu dodania kopii tego pliku do katalogu magazynu kluczy serwera WWW.

Informacje	Wartość
Typ danych	Łańcuch
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.

Unikanie problemów: Pole to jest wyłączone i nie można go zmienić. Wartość jest wyświetlana tylko w celach informacyjnych.gotcha

Nazwa pliku i katalogu magazynu 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.

Unikanie problemów: Pole to jest wyłączone i nie można go zmienić. Wartość jest wyświetlana tylko w celach informacyjnych.gotcha

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 będzie zapisywała komunikaty o błędach.

Informacje	Wartość
Typ danych	Łańcuch
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ółowości komunikatów dziennika, które wtyczka ma zapisywać w dzienniku. 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 podczas 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ść.

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

Informacje	Wartość
Typ danych	Łańcuch
Wartość domyślna	Błąd

Nazwa pliku: uwsv_plugin_props.html