# Roadmaps für die Installation von Web-Server-Plug-ins für WebSphere Application Server Network Deployment

Einführung
Roadmaps für die Plug-in-Installation:

1. Installation von Web-Server-Plug-ins für eigenständige Anwendungsserver
2. Installation von Web-Server-Plug-ins für verteilte Umgebungen

## Installation von Web-Server-Plug-ins für eigenständige Anwendungsserver

| Szenario für Ferninstallation | Szenario für lokale Installation
## Typische Umgebung | # Produktion (empfohlen) | # Entwicklung
## Installation und Konfiguration |
Installation des Anwendungsservers:
(Maschine A)
1. | Installieren Sie IBM Installation Manager.
2. | Verwenden Sie Installation Manager, um WebSphere Application Server Network Deployment zu installieren.
3. | Erstellen Sie einen eigenständigen Anwendungsserver.
Installation von Web-Server und Web Server Plug-ins:
(Maschine B)
4. | Installieren Sie IBM Installation Manager.
5. | Verwenden Sie Installation Manager, um IBM HTTP Server oder einen anderen unterstützten Web-Server zu installieren.
6. | Verwenden Sie Installation Manager, um Web Server Plug-ins for WebSphere Application Server zu installieren.
Konfiguration des Web-Server-Plug-ins:
(Maschine B)
7. | Verwenden Sie Installation Manager, um WebSphere Customization Tools zu installieren.
8. | Öffnen Sie WebSphere Customization Tools, und starten Sie das Konfigurationstool für Web Server Plug-ins, um das Web-Server-Plug-in zu konfigurieren. Das Script für die Erstellung und Konfiguration des Web-Servers wird im Verzeichnis Stammverzeichnis_für_Plug-ins`/bin` erstellt.
9. | Kopieren Sie das Script configureName_des_Web-Servers, um es auf Maschine A einzufügen. Weitere Informationen zum Ausführen der Konfigurationsscripts in den nachfolgend genannten Situationen finden Sie im Abschnitt Plattformübergreifende Hinweise in diesem Dokument: Auf einer Maschine wird Windows und auf der anderen Linux oder UNIX ausgeführt Auf einer Maschine wird eine andere Dateicodierung verwendet
Erstellung der Web-Server-Definition:
(Maschine A)
10. | Fügen Sie das Script `configureName_des_Web-Servers` von Maschine B in das Verzeichnis Stammverzeichnis_des_Anwendungsservers`/bin` auf Maschine A ein.
11. | Starten Sie den Anwendungsserver auf Maschine A.
12. | Führen Sie das Script auf Maschine A aus.
Überprüfung:
(Maschine A)
13. | Stellen Sie sicher, dass der Anwendungsserver aktiv ist.
(Maschine B)
14. | Starten Sie IBM HTTP Server oder einen anderen unterstützten Web-Server.
15. | Führen Sie das Servlet Snoop aus.
| Um das Script zusammen mit Ihrer eigenen Anwendung zu prüfen, generieren Sie die Datei `plugin-cfg.xml` nach der Konfiguration (Installation) der Anwendung erneut und geben sie weiter.
Installation des Anwendungsservers:
(Maschine A)
1. | Installieren Sie IBM Installation Manager.
2. | Verwenden Sie Installation Manager, um WebSphere Application Server Network Deployment zu installieren.
3. | Erstellen Sie einen eigenständigen Anwendungsserver.
Installation von Web-Server und Web Server Plug-ins:
(Maschine A)
4. | Verwenden Sie Installation Manager, um IBM HTTP Server oder einen anderen unterstützten Web-Server zu installieren.
5. | Verwenden Sie Installation Manager, um Web Server Plug-ins for WebSphere Application Server zu installieren.
Konfiguration des Web-Server-Plug-ins und Erstellung der Web-Server-Definition:
(Maschine A)
6. | Verwenden Sie Installation Manager, um WebSphere Customization Tools zu installieren.
7. | Öffnen Sie WebSphere Customization Tools, und starten Sie das Konfigurationstool für Web Server Plug-ins, um das Web-Server-Plug-in zu konfigurieren und die Web-Server-Definition zu erstellen.
8. | Starten Sie den Anwendungsserver.
Überprüfung:
(Maschine A)
9. | Stellen Sie sicher, dass der Anwendungsserver aktiv ist.
10. | Starten Sie IBM HTTP Server oder einen anderen unterstützten Web-Server.
11. | Führen Sie das Servlet Snoop aus.
## Neugenerierung der Datei `plugin-cfg.xml` | Während der Konfiguration wird die temporäre Datei `plugin-cfg.xml` auf der Maschine B im Verzeichnis Stammverzeichnis_für_Plug-ins`/config/Name_des_Web-Servers` installiert. Der Konfigurationsservice für die Web-Server-Plug-ins generiert die Datei `plugin-cfg.xml` automatisch erneut. Wenn Sie die tatsächliche Datei `plugin-cfg.xml` aus dem Anwendungsserver verwenden möchten, geben Sie die Datei `plugin-cfg.xml` gemäß der Beschreibung im nächsten Abschnitt weiter. | Der Konfigurationsservice für die Web-Server-Plug-ins generiert die Datei `plugin-cfg.xml` automatisch erneut. Die Datei `plugin-cfg.xml` wird im Verzeichnis Profilstammverzeichnis`/config/cells/Zellenname/nodes/Knotenname/servers/Name_des_Web-Servers` generiert, wenn die Web-Server-Definition erstellt wird.
## Weitergabe der Datei `plugin-cfg.xml` | Der Konfigurationsservice für die Web-Server-Plug-ins gibt die Datei `plugin-cfg.xml` nur für IBM HTTP Server automatisch weiter. Zum Aktivieren der automatischen Weitergabe führen Sie das einmalige Setup durch. Für alle anderen Web-Server geben Sie die Plug-in-Konfigurationsdatei weiter, indem Sie die Datei `plugin-cfg.xml` im Verzeichnis Profilstammverzeichnis `/config/cells/Zellenname/nodes/Knotenname/servers/ Name_des_Web-Servers` auf der Maschine A manuell in das Verzeichnis `Stammverzeichnis_für_Plug-ins/config/Name_des_Web-Servers` auf der Maschine B kopieren. | Verwenden Sie die Weitergabeoption, um die Datei `plugin-cfg.xml` aus dem Verzeichnis Profilstammverzeichnis/config/cells/Zellenname /nodes/Knotenname/servers/Name_des_Web-Servers in das Verzeichnis Stammverzeichnis_für_Plug-ins/config/Name_des_Web-Servers zu verschieben.

### Ferne Topologie | ### Lokale Topologie

# Installation von Web-Server-Plug-ins für verteilte Umgebungen (Zellen)
| Szenario für ferne verteilte Installation | Szenario für lokale verteilte Installation
## Typische Umgebung | # Produktion (empfohlen) | # Entwicklung
## Installation und Konfiguration |
Installation des Deployment Manager:
(Maschine A)
1. | Installieren Sie IBM Installation Manager.
2. | Verwenden Sie Installation Manager, um WebSphere Application Server Network Deployment zu installieren.
3. | Erstellen Sie ein Deployment-Manager-Profil.
4. | Vergewissern Sie sich, dass der Deployment Manager aktiv ist, damit die Knotensynchronisation geänderter Konfigurationsdatei durchgeführt werden kann.
Installation des Anwendungsservers:
(Maschine B)
5. | Installieren Sie IBM Installation Manager.
6. | Verwenden Sie Installation Manager, um WebSphere Application Server Network Deployment zu installieren.
7. | Erstellen Sie einen eigenständigen Anwendungsserver.
8. | Fügen Sie den Knoten der Deployment-Manager-Zelle hinzu, um den Node-Agent-Prozess zu starten. Starten Sie den Node Agent auf einem vorhandenen verwalteten Knoten. Der Deployment Manager und der Node Agent müssen aktiv sein, damit die Knotensynchronisation geänderter Konfigurationsdateien durchgeführt werden kann.
Installation von Web-Server und Web Server Plug-ins:
(Maschine C)
9. | Installieren Sie IBM Installation Manager.
10. | Verwenden Sie Installation Manager, um IBM HTTP Server oder einen anderen unterstützten Web-Server zu installieren.
11. | Verwenden Sie Installation Manager, um Web Server Plug-ins for WebSphere Application Server zu installieren.
Konfiguration des Web-Server-Plug-ins:
(Maschine C)
12. | Verwenden Sie Installation Manager, um WebSphere Customization Tools zu installieren.
13. | Öffnen Sie WebSphere Customization Tools, und starten Sie das Konfigurationstool für Web Server Plug-ins, um das Web-Server-Plug-in zu konfigurieren. Das Script für die Erstellung und Konfiguration des Web-Servers wird im Verzeichnis Stammverzeichnis_für_Plug-ins`/bin` erstellt.
14. | Kopieren Sie das Script configureName_des_Web-Servers, um es auf Maschine A einzufügen. Weitere Informationen zum Ausführen der Konfigurationsscripts in den nachfolgend genannten Situationen finden Sie im Abschnitt Plattformübergreifende Hinweise in diesem Dokument: Auf einer Maschine wird Windows und auf der anderen Linux oder UNIX ausgeführt Auf einer Maschine wird eine andere Dateicodierung verwendet
Erstellung der Web-Server-Definition:
(Maschine A)
15. | Fügen Sie das Script configureName_des_Web-Servers von der Maschine C in das Verzeichnis Stammverzeichnis_des_Anwendungsservers`/bin` auf der Maschine A ein.
16. | Führen Sie das Script in einer Befehlszeile aus. Dieser Schritt setzt voraus, dass der Deployment Manager und der Node Agent aktiv sind. Wenn Sie die Sicherheit aktiviert oder den JMX-Standardconnectortyp geändert haben, bearbeiten Sie das Script, und fügen Sie die entsprechenden Parameter hinzu.
Überprüfung:
(Maschinen A und B)
17. | Verwenden Sie die Administrationskonsole des Deployment Manager auf der Maschine A, um den Anwendungsserver auf der Maschine B zu starten.
(Maschine C)
18. | Starten Sie IBM HTTP Server oder einen anderen unterstützten Web-Server.
19. | Führen Sie das Servlet Snoop aus.
Anmerkung: Die folgende Prozedur beschreibt die Installation der Plug-ins auf zwei Maschinen. Sie können diese Prozedur jedoch nur auf einer einzigen Maschine ausführen.
Installation des Deployment Manager:
(Maschine A)
1. | Installieren Sie IBM Installation Manager.
2. | Verwenden Sie Installation Manager, um WebSphere Application Server Network Deployment zu installieren.
3. | Erstellen Sie ein Deployment-Manager-Profil.
4. | Vergewissern Sie sich, dass der Deployment Manager aktiv ist, damit die Knotensynchronisation geänderter Konfigurationsdatei durchgeführt werden kann.
Installation des Anwendungsservers:
(Maschine B)
5. | Installieren Sie IBM Installation Manager.
6. | Verwenden Sie Installation Manager, um WebSphere Application Server Network Deployment zu installieren.
7. | Erstellen Sie einen eigenständigen Anwendungsserver.
8. | Fügen Sie den Knoten der Deployment-Manager-Zelle hinzu, um den Node-Agent-Prozess zu starten. Starten Sie den Node Agent auf einem vorhandenen verwalteten Knoten. Der Deployment Manager und der Node Agent müssen aktiv sein, damit die Knotensynchronisation geänderter Konfigurationsdateien durchgeführt werden kann.
Installation von Web-Server und Web Server Plug-ins:
(Maschine B)
9. | Verwenden Sie Installation Manager, um IBM HTTP Server oder einen anderen unterstützten Web-Server zu installieren.
10. | Verwenden Sie Installation Manager, um Web Server Plug-ins for WebSphere Application Server zu installieren.
Konfiguration des Web-Server-Plug-ins:
(Maschine B)
11. | Verwenden Sie Installation Manager, um WebSphere Customization Tools zu installieren.
12. | Öffnen Sie WebSphere Customization Tools, und starten Sie das Konfigurationstool für Web Server Plug-ins, um das Web-Server-Plug-in zu konfigurieren und die Web-Server-Definition zu erstellen. Das Script für die Erstellung und Konfiguration des Web-Servers wird im Verzeichnis Stammverzeichnis_für_Plug-ins`/bin` erstellt.
13. | Kopieren Sie das Script configureName_des_Web-Servers, um es auf Maschine A einzufügen. Weitere Informationen zum Ausführen der Konfigurationsscripts in den nachfolgend genannten Situationen finden Sie im Abschnitt Plattformübergreifende Hinweise in diesem Dokument: Auf einer Maschine wird Windows und auf der anderen Linux oder UNIX ausgeführt Auf einer Maschine wird eine andere Dateicodierung verwendet
Erstellung der Web-Server-Definition:
(Maschine A)
14. | Fügen Sie das Script configureName_des_Web-Servers von der Maschine B in das Verzeichnis Stammverzeichnis_des_Anwendungsservers`/bin` auf der Maschine A ein.
15. | Führen Sie das Script in einer Befehlszeile aus. Dieser Schritt setzt voraus, dass der Deployment Manager und der Node Agent aktiv sind. Wenn Sie die Sicherheit aktiviert oder den JMX-Standardconnectortyp geändert haben, bearbeiten Sie das Script, und fügen Sie die entsprechenden Parameter hinzu.
Überprüfung:
(Maschinen A und B)
16. | Verwenden Sie die Administrationskonsole des Deployment Manager auf der Maschine A, um den Anwendungsserver auf der Maschine B zu starten.
17. | Starten Sie IBM HTTP Server oder einen anderen unterstützten Web-Server. Bevor Sie den Domino-Web-Server auf einem Linux- oder UNIX-System starten, führen Sie das Script Stammverzeichnis_für_Plug-ins`/setupPluginCfg.sh` in der aktuellen Prozessumgebung aus.
18. | Führen Sie das Servlet Snoop aus.
## Neugenerierung der Datei `plugin-cfg.xml` | Während der Konfiguration wird eine temporäre Datei `plugin-cfg.xml` auf der Maschine C im Verzeichnis Stammverzeichnis_für_Plug-ins`/config/Name_des_Web-Servers` installiert. Der Konfigurationsservice für die Web-Server-Plug-ins generiert die Datei `plugin-cfg.xml` automatisch erneut. Wenn Sie die echte Datei `plugin-cfg.xml` aus dem Anwendungsserver verwenden möchten, geben Sie die Datei `plugin-cfg.xml` gemäß der Beschreibung im nächsten Abschnitt weiter. | Die Datei `plugin-cfg.xml` wird im Verzeichnis Profilstammverzeichnis`/config/cells/Zellenname /nodes/Knotenname/servers/Name_des_Web-Servers` generiert, wenn die Web-Server-Definition erstellt wird. Generieren Sie die Datei `plugin-cfg.xml` in der Web-Server-Definition im Anwendungsserver erneut, wenn sich die Konfiguration ändert. Der Web-Server hat unmittelbaren Zugriff auf die Datei, sobald diese neu generiert wird. Wenn der Konfigurationsservice für die Web-Server-Plug-ins (ein Verwaltungsservice) auf der Maschine A aktiviert ist, wird die Datei `plugin-cfg.xml` für alle Web-Server automatisch generiert.
## Weitergabe der Datei `plugin-cfg.xml` | Der Konfigurationsservice für die Web-Server-Plug-ins gibt die Datei `plugin-cfg.xml` nur für IBM HTTP Server automatisch weiter. Zum Aktivieren der automatischen Weitergabe führen Sie das einmalige Setup durch, das im letzten Abschnitt dieser Roadmap beschrieben ist. Für alle anderen Web-Server geben Sie die Plug-in-Konfigurationsdatei weiter, indem Sie die Datei `plugin-cfg.xml` im Verzeichnis Profilstammverzeichnis `/config/cells/Zellenname/nodes/Knotenname/servers/ Name_des_Web-Servers` auf der Maschine A manuell in das Verzeichnis Stammverzeichnis_für_Plug-ins `/config/Name_des_Web-Servers` auf der Maschine C kopieren. | Verwenden Sie die Weitergabeoption, um die Datei `plugin-cfg.xml` aus dem Verzeichnis Profilstammverzeichnis/config/cells/Zellenname /nodes/Knotenname/servers/Name_des_Web-Servers in das Verzeichnis Stammverzeichnis_für_Plug-ins/config/Name_des_Web-Servers zu verschieben.

### Ferne Topologie | ### Lokale Topologie

# Setup- und Fehlerbehebungsprozedur für automatische Weitergabe Der Konfigurationsservice für die Web-Server-Plug-ins gibt die Datei `plugin-cfg.xml` nur für IBM HTTP Server automatisch weiter. Führen Sie zum Aktivieren der automatischen Weitergabe die folgende einmalige Setup-Prozedur aus: Erstellen Sie einen Benutzer "adminUser" mit dem Kennwort "adminPassword2 in der Datei IHS-Stammverzeichnis`/conf/admin.passwd`, z. B. "c:\ws\ihs85\bin\htpasswd -cb c:\ws\ihs85\conf\admin.passwd adminUser adminPassword". Klicken Sie in der Administrationskonsole auf Server > Web-Server > webserver1 > Verwaltung des fernen Web-Servers. Definieren Sie die folgenden Werte: admin Port=8008, User Id=adminUser, Password=adminPassword. Definieren Sie die richtigen Lese-/Schreibberechtigungen für die Datei `httpd.conf` und die Datei `plugin-cfg.xml`. Weitere Informationen finden Sie in der Datei IHS-Stammverzeichnis`/logs/admin_error.log`. Die automatische Weitergabe der Plug-in-Konfigurationsdatei setzt voraus, dass der Administrationsserver für IBM HTTP Server betriebsbereit ist. Wenn Sie einen IBM HTTP Server über die Administrationskonsole von WebSphere Application Server verwalten, kann der folgende Fehler angezeigt werden:
    "Es konnte keine Verbindung zum IHS-Administrationsserver hergestellt werden"
Führen Sie die folgende Prozedur aus: Vergewissern Sie sich, dass der Administrationsserver von IBM HTTP Server aktiv ist. Vergewissern Sie sich, dass der Hostname und der Port des Web-Servers, die in der Administrationskonsole von WebSphere Application Server definiert sind, mit dem Hostnamen und dem Port des Administrationsservers von IBM HTTP Server übereinstimmen. Vergewissern Sie sich, dass die Firewall den Zugriff auf den Administrationsserver von IBM HTTP Server über die Administrationskonsole von WebSphere Application Server nicht verhindert. Vergewissern Sie sich, dass die Benutzer-ID und das Kennwort, die in der Administrationskonsole von WebSphere Application Server unter der Fernverwaltung aufgeführt sind, mit dem Befehl "htpasswd" in der Datei `admin.passwd` erstellt werden. Wenn Sie versuchen, eine sichere Verbindung herzustellen, müssen Sie das persönliche Zertifikat für die Schlüsseldatenbank des Administrationsservers von IBM HTTP Server als Unterzeichnerzertifikat in die Schlüsseldatenbank von WebSphere Application Server exportieren. Diese Schlüsseldatenbank wird mit der Anweisung `com.ibm.ssl.trustStore` in der Datei `sas.client.props` des Profils angegeben, unter dem Ihre Administrationskonsole ausgeführt wird. Dieser Hinweis gilt primär für selbst signierte Zertifikate. Wenn Sie weiterhin Probleme haben, überprüfen Sie die Datei `admin_error.log` von IBM HTTP Server und die Protokolle von WebSphere Application Server (Datei `trace.log`), um die Ursache des Problems festzustellen.

- # Plattformübergreifende Hinweise für die Ausführung des Konfigurationsscripts Bei der Konfiguration eines fernen Web-Servers sind diverse Unterschiede bei den Betriebssystemen und Maschinenplattformen zu beachten: Auf einer Maschine wird Windows und auf der anderen Linux oder UNIX ausgeführt Auf einer Maschine wird eine andere Standardcodierung als auf der anderen verwendet Auf einer Maschine wird Windows und auf der anderen Linux oder UNIX ausgeführt Wenn auf einer Maschine Linux oder UNIX und auf der anderen Maschine Windows ausgeführt wird, verwenden Sie das im Verzeichnis `Stammverzeichnis_für_Plug-ins /bin/crossPlatformScripts` erstellte Script. Auf einer Maschine wird eine andere Standardcodierung als auf der anderen verwendet Der Inhalt des Scripts `configureName_des_Web-Servers.bat` oder das Script `configure Name_des_Web-Servers.sh` kann beschädigt sein, wenn auf den beiden Maschinen unterschiedliche Standarddateicodierungen verwendet werden. Dieses Szenario ist möglich, wenn auf einer Maschine ein Doppelbytezeichensatz (DBCS) konfiguriert ist und auf der anderen nicht. Bestimmen Sie die Dateicodierung jeder Maschine, und verwenden Sie eine der folgenden Prozeduren als Problemumgehung. Führen Sie zum Bestimmen der Standarddateicodierung den entsprechenden Befehl aus: Windows-Systeme:
      CHCP
- Linux- und UNIX-Systeme:
      locale
Verwenden Sie das Ergebnis des Befehls auf jeder Maschine als Wert für die Variable Codierung_der_Web-Server-Maschine und die Variable Codierung der Anwendungsservermaschine in den folgenden Prozeduren. Prozeduren für die Behebung von Codierungsdifferenzen Angenommen, der Web-Server wird auf einer Linux-Maschine und Network Deployment auf einer Windows-Maschine ausgeführt. Web-Server auf einer Linux-Maschine Führen Sie den folgenden Befehl auf dem Linux- bzw. UNIX-System aus, um die Scriptdatei zu codieren, die die Web-Server-Definition konfiguriert, bevor Sie die Datei mit FTP im Binärmodus auf die Windows-Maschine übertragen:
    iconv -f Codierung_der_Web-Server-Maschine \
          -t Codierung_der_Anwendungsservermaschine \
             configureName_des_Web-Servers.bat
Lassen Sie die Linux- und UNIX-Fortsetzungszeichen (\) weg, wenn Sie den Befehl in einer einzigen Zeile angeben. Wichtig: Der Name des Web-Servers (Kurzname) wird im Namen der Scriptdatei verwendet. Der Name darf keine Zeichen aus einem Doppelbytezeichensatz (DBCS) enthalten, wenn Sie IBM HTTP Server für die automatische Weitergabe konfigurieren möchten. Angenommen, der Web-Server wird auf einer Windows-Maschine und Network Deployment auf einer Linux- oder UNIX-Maschine ausgeführt. Web-Server auf einer Windows-Maschine Führen Sie den folgenden Befehl auf dem Linux- oder UNIX-System aus, um die Scriptdatei zu codieren, die die Web-Server-Definition konfiguriert, nachdem Sie die Datei im Binärmodus mit FTP übertragen haben:
    iconv -f Codierung_der_Web-Server-Maschine \
          -t Codierung_der_Anwendungsservermaschine \
             configureName_des_Web-Servers.sh
Lassen Sie die Linux- und UNIX-Fortsetzungszeichen (\) weg, wenn Sie den Befehl in einer einzigen Zeile angeben. Wenn die Konvertierungszuordnung vom Befehl "iconv" auf Ihrem System nicht unterstützt wird, kopieren Sie den Inhalt des Web-Server-Konfigurationsscripts in die Zwischenablage, und fügen Sie ihn dann auf der Maschine ein, auf der der Anwendungsserver ausgeführt wird.