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

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:

  1. 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".
  2. 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.
  3. 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:

  1. Vergewissern Sie sich, dass der Administrationsserver von IBM HTTP Server aktiv ist.
  2. 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.
  3. Vergewissern Sie sich, dass die Firewall den Zugriff auf den Administrationsserver von IBM HTTP Server über die Administrationskonsole von WebSphere Application Server nicht verhindert.
  4. 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.
  5. 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.
  6. 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.