# Przewodniki przejścia dotyczące instalacji wtyczek serwera WWW dla produktu WebSphere Application Server Network Deployment

Pierwsze kroki
Przewodniki instalacji wtyczki:

1. Instalacja wtyczki serwera WWW dla autonomicznych serwerów aplikacji
2. Instalacja wtyczki serwera WWW dla środowisk rozproszonych

## Instalacja wtyczki serwera WWW dla autonomicznych serwerów aplikacji

| Scenariusz instalacji zdalnej | Scenariusz instalacji lokalnej
## Typowe środowisko | # Produkcyjne (zalecane) | # Programistyczne
## Instalacja i konfiguracja |
Instalacja serwera aplikacji:
(Komputer A)
1. | Zainstaluj program IBM Installation Manager.
2. | Przy użyciu programu Installation Manager zainstaluj produkt WebSphere Application Server Network Deployment.
3. | Utwórz autonomiczny serwer aplikacji.
Instalacja serwera WWW i wtyczek serwera WWW:
(Komputer B)
4. | Zainstaluj program IBM Installation Manager.
5. | Przy użyciu programu Installation Manager zainstaluj serwer IBM HTTP Server lub inny obsługiwany serwer WWW.
6. | Przy użyciu programu Installation Manager zainstaluj wtyczki serwera WWW dla serwera WebSphere Application Server.
Konfigurowanie wtyczki serwera WWW:
(Komputer B)
7. | Przy użyciu programu Installation Manager zainstaluj narzędzie WebSphere Customization Tools.
8. | Otwórz narzędzie WebSphere Customization Tools i uruchom narzędzie konfiguracji wtyczek serwera WWW w celu skonfigurowania wtyczki serwera WWW. Skrypt dotyczący tworzenia i konfigurowania serwera WWW jest tworzony w katalogu katalog_główny_wtyczek`/bin`.
9. | Skopiuj skrypt configure nazwa_serwera_WWW, aby wkleić go na komputerze A. W sekcji Zagadnienia wieloplatformowe przedstawiono więcej informacji na temat uruchamiania skryptów konfiguracyjnych w sytuacji, gdy: Jeden z komputerów używa systemu Windows, a drugi systemu Linux lub UNIX. Jeden z komputerów używa innego kodowania plików.
Tworzenie definicji serwera WWW:
(Komputer A)
10. | Wklej skrypt `configurenazwa_serwera_WWW` z komputera B do katalogu katalog_główny_serwera_aplikacji`/bin` na komputerze A
11. | Uruchom serwer aplikacji na komputerze A.
12. | Uruchom skrypt na komputerze A.
Sprawdzanie poprawności:
(Komputer A)
13. | Sprawdź, czy serwer aplikacji jest uruchomiony.
(Komputer B)
14. | Uruchom serwer IBM HTTP Server lub inny obsługiwany serwer WWW.
15. | Uruchom serwlet Snoop.
| Aby do sprawdzenia poprawności użyć własnej aplikacji, po skonfigurowaniu (zainstalowaniu) aplikacji wygeneruj ponownie plik `plugin-cfg.xml`, a następnie propaguj go.
Instalacja serwera aplikacji:
(Komputer A)
1. | Zainstaluj program IBM Installation Manager.
2. | Przy użyciu programu Installation Manager zainstaluj produkt WebSphere Application Server Network Deployment.
3. | Utwórz autonomiczny serwer aplikacji.
Instalacja serwera WWW i wtyczek serwera WWW:
(Komputer A)
4. | Przy użyciu programu Installation Manager zainstaluj serwer IBM HTTP Server lub inny obsługiwany serwer WWW.
5. | Przy użyciu programu Installation Manager zainstaluj wtyczki serwera WWW dla serwera WebSphere Application Server.
Konfigurowanie wtyczki serwera WWW i tworzenie definicji serwera WWW:
(Komputer A)
6. | Przy użyciu programu Installation Manager zainstaluj narzędzie WebSphere Customization Tools.
7. | Otwórz narzędzie WebSphere Customization Tools i uruchom narzędzie konfiguracji wtyczek serwera WWW w celu skonfigurowania wtyczki serwera WWW i utworzenia definicji serwera WWW.
8. | Uruchom serwer aplikacji.
Sprawdzanie poprawności:
(Komputer A)
9. | Sprawdź, czy serwer aplikacji jest uruchomiony.
10. | Uruchom serwer IBM HTTP Server lub inny obsługiwany serwer WWW.
11. | Uruchom serwlet Snoop.
## Generowanie pliku `plugin-cfg.xml` | Podczas konfiguracji plik tymczasowy `plugin-cfg.xml` jest instalowany na komputerze B w katalogu katalog_główny_wtyczek`/config/nazwa_serwera_WWW` . Usługa konfiguracji wtyczki serwera WWW automatycznie ponownie generuje plik `plugin-cfg.xml`. Aby używać bieżącego pliku `plugin-cfg.xml` z serwera aplikacji, należy propagować plik `plugin-cfg.xml` w sposób opisany w następnej sekcji. | Usługa konfiguracji wtyczki serwera WWW automatycznie ponownie generuje plik `plugin-cfg.xml`. Plik `plugin-cfg.xml` jest generowany w położeniu katalog_główny_profilu`/config/cells/nazwa_komórki /nodes/nazwa_węzła/servers/nazwa_serwera_WWW` podczas tworzenia definicji serwera WWW.
## Propagowanie pliku `plugin-cfg.xml` | Usługa konfiguracji wtyczki serwera WWW automatycznie propaguje plik `plugin-cfg.xml` tylko dla produktu IBM HTTP Server. Aby włączyć automatyczną propagację, wykonaj jednorazową czynność konfiguracyjną. W przypadku wszystkich innych serwerów WWW plik konfiguracyjny wtyczki należy propagować przez ręczne skopiowanie pliku `plugin-cfg.xml` z katalogu katalog_główny_profilu`/config/cells/nazwa_komórki/nodes/nazwa_węzła/servers/ nazwa_serwera_WWW` na komputerze A do katalogu `katalog_główny_wtyczek/config/nazwa_serwera_WWW` na komputerze B. | Przy użyciu opcji propagowania przenieś plik `plugin-cfg.xml` z katalogu katalog_główny_profilu/config/cells/nazwa_komórki /nodes/nazwa_węzła/servers/nazwa_serwera_WWW do katalogu katalog_główny_wtyczek/config/nazwa_serwera_WWW.

### Topologia zdalna | ### Topologia lokalna

# Instalacja wtyczki serwera WWW dla środowisk rozproszonych (komórek)
| Scenariusz rozproszonej instalacji zdalnej | Scenariusz rozproszonej instalacji lokalnej
## Typowe środowisko | # Produkcyjne (zalecane) | # Programistyczne
## Instalacja i konfiguracja |
Instalacja menedżera wdrażania:
(Komputer A)
1. | Zainstaluj program IBM Installation Manager.
2. | Przy użyciu programu Installation Manager zainstaluj produkt WebSphere Application Server Network Deployment.
3. | Utwórz profil menedżera wdrażania.
4. | Sprawdź, czy menedżer wdrażania jest uruchomiony, aby umożliwić synchronizację węzła zmienionych plików konfiguracyjnych.
Instalacja serwera aplikacji:
(Komputer B)
5. | Zainstaluj program IBM Installation Manager.
6. | Przy użyciu programu Installation Manager zainstaluj produkt WebSphere Application Server Network Deployment.
7. | Utwórz autonomiczny serwer aplikacji.
8. | Dodaj węzeł do komórki menedżera wdrażania, aby uruchomić proces agenta węzła. Uruchom agenta węzła w istniejącym węźle zarządzanym. Menedżer wdrażania i agent węzła muszą być uruchomione, aby umożliwić synchronizację węzła zmienionych plików konfiguracyjnych.
Instalacja serwera WWW i wtyczek serwera WWW:
(Komputer C)
9. | Zainstaluj program IBM Installation Manager.
10. | Przy użyciu programu Installation Manager zainstaluj serwer IBM HTTP Server lub inny obsługiwany serwer WWW.
11. | Przy użyciu programu Installation Manager zainstaluj wtyczki serwera WWW dla serwera WebSphere Application Server.
Konfigurowanie wtyczki serwera WWW:
(Komputer C)
12. | Przy użyciu programu Installation Manager zainstaluj narzędzie WebSphere Customization Tools.
13. | Otwórz narzędzie WebSphere Customization Tools i uruchom narzędzie konfiguracji wtyczek serwera WWW w celu skonfigurowania wtyczki serwera WWW. Skrypt dotyczący tworzenia i konfigurowania serwera WWW jest tworzony w katalogu katalog_główny_wtyczek`/bin`.
14. | Skopiuj skrypt configurenazwa_serwera_WWW, aby wkleić go na komputerze A. W sekcji Zagadnienia wieloplatformowe przedstawiono więcej informacji na temat uruchamiania skryptów konfiguracyjnych w sytuacji, gdy: Jeden z komputerów używa systemu Windows, a drugi systemu Linux lub UNIX. Jeden z komputerów używa innego kodowania plików.
Tworzenie definicji serwera WWW:
(Komputer A)
15. | Wklej skrypt configurenazwa_serwera_WWW z komputera C do katalogu katalog_główny_serwera_aplikacji `/bin` na komputerze A.
16. | Uruchom skrypt z poziomu wiersza komendy. Aby wykonać tę czynność, menedżer wdrażania i agent węzła muszą być uruchomione. Jeśli włączono zabezpieczenia lub zmieniono domyślny typ konektora JMX, należy edytować skrypt i uwzględnić odpowiednie parametry.
Sprawdzanie poprawności:
(Komputery A i B)
17. | Użyj Konsoli administracyjnej menedżera wdrażania na komputerze A, aby uruchomić serwer aplikacji na komputerze B.
(Komputer C)
18. | Uruchom serwer IBM HTTP Server lub inny obsługiwany serwer WWW.
19. | Uruchom serwlet Snoop.
Uwaga: Poniżej została opisana procedura instalowania wtyczek na dwóch komputerach. Jednak można ją wykonać na pojedynczym komputerze.
Instalacja menedżera wdrażania:
(Komputer A)
1. | Zainstaluj program IBM Installation Manager.
2. | Przy użyciu programu Installation Manager zainstaluj produkt WebSphere Application Server Network Deployment.
3. | Utwórz profil menedżera wdrażania.
4. | Sprawdź, czy menedżer wdrażania jest uruchomiony, aby umożliwić synchronizację węzła zmienionych plików konfiguracyjnych.
Instalacja serwera aplikacji:
(Komputer B)
5. | Zainstaluj program IBM Installation Manager.
6. | Przy użyciu programu Installation Manager zainstaluj produkt WebSphere Application Server Network Deployment.
7. | Utwórz autonomiczny serwer aplikacji.
8. | Dodaj węzeł do komórki menedżera wdrażania, aby uruchomić proces agenta węzła. Uruchom agenta węzła w istniejącym węźle zarządzanym. Menedżer wdrażania i agent węzła muszą być uruchomione, aby umożliwić synchronizację węzła zmienionych plików konfiguracyjnych.
Instalacja serwera WWW i wtyczek serwera WWW:
(Komputer B)
9. | Przy użyciu programu Installation Manager zainstaluj serwer IBM HTTP Server lub inny obsługiwany serwer WWW.
10. | Przy użyciu programu Installation Manager zainstaluj wtyczki serwera WWW dla serwera WebSphere Application Server.
Konfigurowanie wtyczki serwera WWW:
(Komputer B)
11. | Przy użyciu programu Installation Manager zainstaluj narzędzie WebSphere Customization Tools.
12. | Otwórz narzędzie WebSphere Customization Tools i uruchom narzędzie konfiguracji wtyczek serwera WWW w celu skonfigurowania wtyczki serwera WWW i utworzenia definicji serwera WWW. Skrypt dotyczący tworzenia i konfigurowania serwera WWW jest tworzony w katalogu katalog_główny_wtyczek`/bin`.
13. | Skopiuj skrypt configure nazwa_serwera_WWW, aby wkleić go na komputerze A. W sekcji Zagadnienia wieloplatformowe przedstawiono więcej informacji na temat uruchamiania skryptów konfiguracyjnych w sytuacji, gdy: Jeden z komputerów używa systemu Windows, a drugi systemu Linux lub UNIX. Jeden z komputerów używa innego kodowania plików.
Tworzenie definicji serwera WWW:
(Komputer A)
14. | Wklej skrypt configurenazwa_serwera_WWW z komputera B do katalogu katalog_główny_serwera_aplikacji `/bin` na komputerze A.
15. | Uruchom skrypt z poziomu wiersza komendy. Aby wykonać tę czynność, menedżer wdrażania i agent węzła muszą być uruchomione. Jeśli włączono zabezpieczenia lub zmieniono domyślny typ konektora JMX, należy edytować skrypt i uwzględnić odpowiednie parametry.
Sprawdzanie poprawności:
(Komputery A i B)
16. | Użyj Konsoli administracyjnej menedżera wdrażania na komputerze A, aby uruchomić serwer aplikacji na komputerze B.
17. | Uruchom serwer IBM HTTP Server lub inny obsługiwany serwer WWW. Przed uruchomieniem produktu Domino Web Server w systemie Linux lub UNIX, ustaw skrypt katalog_główny_wtyczek`/setupPluginCfg.sh` jako źródło.
18. | Uruchom serwlet Snoop.
## Generowanie pliku `plugin-cfg.xml` | Podczas konfiguracji plik tymczasowy `plugin-cfg.xml` jest instalowany na komputerze C w katalogu katalog_główny_wtyczek`/config/nazwa_serwera_WWW` . Usługa konfiguracji wtyczki serwera WWW automatycznie ponownie generuje plik `plugin-cfg.xml`. Aby używać rzeczywistego pliku `plugin-cfg.xml` z serwera aplikacji, należy propagować plik `plugin-cfg.xml` w sposób opisany w następnej sekcji. | Plik `plugin-cfg.xml` jest generowany w katalogu katalog_główny_profilu`/config/komórki/nazwa_komórki /węzły/nazwa_węzła/serwery/nazwa_serwera_WWW` podczas tworzenia definicji serwera WWW. Wygeneruj ponownie plik `plugin-cfg.xml` w definicji serwera WWW na serwerze aplikacji po każdym wprowadzeniu zmian w konfiguracji. Serwer WWW uzyskuje natychmiastowy dostęp do pliku, gdy tylko plik zostanie ponownie wygenerowany. Plik `plugin-cfg.xml` zostaje automatycznie wygenerowany dla wszystkich serwerów WWW, jeśli usługa konfiguracji wtyczki serwera WWW (usługa administracyjna) jest włączona na komputerze A.
## Propagowanie pliku `plugin-cfg.xml` | Usługa konfiguracji wtyczki serwera WWW automatycznie propaguje plik `plugin-cfg.xml` tylko dla produktu IBM HTTP Server. Aby włączyć automatyczną propagację, wykonaj jednorazową czynność konfiguracyjną opisaną w ostatniej sekcji przewodnika przejścia. W przypadku wszystkich innych serwerów WWW plik konfiguracyjny wtyczki należy propagować przez ręczne skopiowanie pliku `plugin-cfg.xml` z katalogu katalog_główny_profilu`/config/cells/nazwa_komórki/nodes/nazwa_węzła/servers/ nazwa_serwera_WWW` na komputerze A do katalogu katalog_główny_wtyczek`/config/nazwa_serwera_WWW` na komputerze C. | Przy użyciu opcji propagowania przenieś plik `plugin-cfg.xml` z katalogu katalog_główny_profilu/config/cells/nazwa_komórki/nodes/nazwa_węzła/servers/nazwa_serwera_WWW do katalogu katalog_główny_wtyczek/config/nazwa_serwera_WWW.

### Topologia zdalna | ### Topologia lokalna

# Procedura instalowania i rozwiązywania problemów automatycznej propagacji Usługa konfiguracji wtyczki serwera WWW automatycznie propaguje plik `plugin-cfg.xml` tylko dla produktu IBM HTTP Server. Aby włączyć automatyczną propagację, wykonaj następującą jednorazową czynność konfiguracyjną: Utwórz parametry user=adminUser, password=adminPassword w pliku katalog_główny_serwera_IHS`/conf/admin.passwd`. Na przykład: c:\ws\ihs85\bin\htpasswd -cb c:\ws\ihs85\conf\admin.passwd adminUser adminPassword W Konsoli administracyjnej kliknij opcję Serwery > Serwery WWW > serwer webserver1 > Zarządzanie zdalne serwerem WWW. Ustaw następujące wartości: admin Port=8008, User Id=adminUser, Password=adminPassword. Ustaw poprawne uprawnienia do odczytu/zapisu pliku `httpd.conf` i pliku `plugin-cfg.xml`. Więcej informacji zawiera plik katalog_główny_serwera_IHS`/logs/admin_error.log`. Automatyczna propagacja pliku konfiguracyjnego wtyczki wymaga, aby serwer administracyjny IBM HTTP Server był zainstalowany i uruchomiony. Jeśli do zarządzania serwerem IBM HTTP Server używana jest Konsola administracyjna serwera WebSphere Application Server, może zostać wyświetlony następujący błąd:
    Błąd: nie można nawiązać połączenia z serwerem administracyjnym IHS
Wykonaj następującą procedurę: Sprawdź, czy serwer administracyjny IBM HTTP Server jest uruchomiony. Sprawdź, czy nazwa hosta i port serwera WWW zdefiniowane w Konsoli administracyjnej serwera WebSphere Application Server są zgodne z nazwą hosta i portem administracyjnego serwera IBM HTTP Server. Sprawdź, czy firewall nie uniemożliwia uzyskania dostępu do serwera administracyjnego IBM HTTP Server z poziomu Konsoli administracyjnej serwera WebSphere Application Server. Sprawdź, czy identyfikator użytkownika i hasło określone w Konsoli administracyjnej serwera WebSphere Application Server w ramach zdalnego zarządzania zostały utworzone w pliku `admin.passwd`, używając komendy htpasswd. W przypadku próby nawiązania bezpiecznego połączenia sprawdź, czy certyfikat osobisty bazy danych kluczy serwera administracyjnego IBM HTTP Server został wyeksportowany do bazy danych kluczy serwera WebSphere Application Server jako certyfikat osoby podpisującej. Baza danych kluczy jest określona przez dyrektywę `com.ibm.ssl.trustStore` w pliku `sas.client.props` profilu, w którym uruchomiona jest Konsola administracyjna. Ta uwaga dotyczy głównie certyfikatów samopodpisanych. Jeśli problemy występują nadal, sprawdź plik `admin_error.log` serwera IBM HTTP Server i dzienniki produktu WebSphere Application Server (plik `trace.log`), aby określić przyczynę problemu.

- # Zagadnienia wieloplatformowe uruchamiania skryptu konfiguracyjnego Podczas konfigurowania zdalnego serwera WWW mogą wystąpić różnice między poszczególnymi systemami operacyjnymi i platformami komputera: Jeden z komputerów używa systemu Windows, a drugi systemu Linux lub UNIX. Jeden z komputerów używa innego kodowania domyślnego. Jeden z komputerów używa systemu Windows, a drugi systemu Linux lub UNIX. Jeśli jeden z komputerów używa systemu Linux lub UNIX, a drugi systemu Windows, użyj skryptu utworzonego w katalogu `katalog_główny_wtyczek/bin/crossPlatformScripts`. Jeden z komputerów używa innego kodowania domyślnego Treść skryptu `configurenazwa_serwera_WWW.bat` lub `configurenazwa_serwera_WWW.sh` może być uszkodzona, jeśli domyślne kodowanie plików na dwóch komputerach jest różne. Taki scenariusz jest możliwy, gdy jeden z komputerów jest skonfigurowany do obsługi ustawień narodowych używających zestawu znaków dwubajtowych (DBCS), a drugi nie. Obejściem tego problemu jest określenie kodowania plików dla każdego komputera i użycie jednej z następujących procedur. Aby określić domyślne kodowanie plików, uruchom odpowiednią komendę: Systemy Windows:
      CHCP
- Systemy Linux i UNIX:
      locale
Wyniku wykonania komendy na każdym komputerze należy użyć jako wartości zmiennych kodowanie_plików_komputera_z_serwerem_WWW i kodowanie_plików_komputera_z_serwerem_aplikacji w jednej z następujących procedur. Procedury niwelowania różnic kodowania Na potrzeby tego przykładu należy założyć, że serwer WWW działa na komputerze z systemem Linux, a produkt Network Deployment działa na komputerze z systemem Windows. Serwer WWW działający w systemie Linux Aby zakodować plik skryptowy, który konfiguruje definicję serwera WWW, zanim plik zostanie przesłany za pośrednictwem protokołu FTP w trybie binarnym na komputer z systemem Windows, uruchom następującą komendę w systemie Linux lub UNIX:
    iconv -f kodowanie_plików_komputera_z_serwerem_WWW \
          -t kodowanie_plików_komputera_z_serwerem_aplikacji \
             configurenazwa_serwera_WWW.bat
Jeśli komenda jest wprowadzana w jednym wierszu, pomiń znaki kontynuacji (\) w systemach Linux i UNIX. Ważne: Nazwa serwera WWW (pseudonim) jest używana w nazwie pliku skryptowego. Nazwa nie może zawierać znaków z zestawu znaków dwubajtowych (DBCS), jeśli serwer IBM HTTP Server ma zostać skonfigurowany w celu automatycznej propagacji. Na potrzeby tego przykładu należy założyć, że serwer WWW działa na komputerze z systemem Windows, a produkt Network Deployment działa na komputerze z systemem Linux lub UNIX. Serwer WWW działający w systemie Windows Aby zakodować plik skryptowy, który konfiguruje definicję serwera WWW, po przesłaniu pliku za pośrednictwem protokołu FTP w trybie binarnym, uruchom następującą komendę w systemie Linux lub UNIX:
    iconv -f kodowanie_plików_komputera_z_serwerem_WWW \
          -t kodowanie_plików_komputera_z_serwerem_aplikacji \
             configurenazwa_serwera_WWW.sh
Jeśli komenda jest wprowadzana w jednym wierszu, pomiń znaki kontynuacji (\) w systemach Linux i UNIX. Jeśli w danym systemie odwzorowanie konwersji nie jest obsługiwane przez komendę iconv, treść skryptu konfiguracyjnego serwera WWW należy skopiować do schowka i wkleić ją na komputerze, na którym jest uruchomiony serwer aplikacji.