Für verteilte PlattformenFür z/OS-Plattformen

Dynamic Routing für Liberty-Verbünde konfigurieren

Das Feature "Dynamic Routing" ermöglicht die Weiterleitung von HTTP-Anforderungen an Member von Liberty-Verbünden, ohne dass die Konfigurationsdatei für das WebSphere-Plug-in bei einer Änderung der Umgebung neu generiert werden muss. Wenn Server, Cluster-Member, Anwendungen oder virtuelle Hosts hinzugefügt, entfernt, gestartet, gestoppt oder modifiziert werden, werden die neuen Informationen dynamisch für das WebSphere-Plug-in bereitgestellt. Anforderungen werden ausgehend von aktuellen Informationen weitergeleitet. Das Feature stellt den Dynamic Routing-Service bereit, der Routing-Informationen dynamisch vom Verbundrepository abruft und diese Informationen an das WebSphere-Plug-in übergibt. Außerdem stellt das Feature drei neue Aktionen für den Befehl "dynamicRouting" für Verbünde bereit. Diese Aktionen werden zusammen verwendet, um einen Keystore für die sichere Kommunikation zwischen dem Plug-in und dem Dynamic Routing-Service sowie eine Plug-in-Konfigurationsdatei für Intelligent Management im WebSphere-Plug-in zu generieren.

Vorbereitende Schritte

Damit die Dynamic Routing-Funktion funktioniert, muss das Feature "dynamicRouting" ausschließlich in Verbundcontrollern vorhanden sein. Es ist nicht erforderlich, jedes Verbundmember zu aktualisieren. Dynamic Routing kann verwendet werden, um Anforderungen an Anwendungen weiterzuleiten, die auf einem Liberty-Server in einem Verbund installiert sind, wie z. B. die Network Deployment-, Core- und Base-Editionen.

Wichtig: Der vorläufige Fix für Intelligent Management in Web Server Plug-in for WebSphere Application Server (APAR-Nummer PI27023) ist für die Verwendung des Features "Dynamic Routing" erforderlich. Sie müssen einen Web-Server installieren, der von Web Server Plug-in for WebSphere Application Server unterstützt wird, wie z. B. IBM HTTP Server. Installieren Sie ein Web-Server-Plug-in mit Version 8.5.5 oder höher für WebSphere Application Server und anschließend den vorläufigen Fix, bevor Sie das Feature "Dynamic Routing" aktivieren.
  1. Laden Sie die neueste Version von IBM Installation Manager herunter und installieren Sie sie. Weitere Informationen zur Installation von IBM Installation Manager finden Sie unter Installation Manager installieren und Produktinstallation vorbereiten.
  2. Verwenden Sie Installation Manager, um auf die Onlineproduktrepositorys für die Intallation von Web Server Plug-ins for WebSphere Application Server und des erforderlichen vorläufigen Fix für das Feature "Dynamic Routing" zuzugreifen. Öffnen Sie die Benutzervorgabenseite in der grafischen Benutzerschnittstelle von Installation Manager. Wählen Sie dazu Datei > Benutzervorgaben aus. Installieren Sie mit Installation Manager das Produkt aus dem webbasierten Repository unter
    http://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLGILAN.v85
    .
    Anmerkung: Für den Zugriff auf das Repository benötigen Sie eine IBM ID. Dieses Repository ist nur für verteilte Plattformen bestimmt.
  3. Verwenden Sie den Installationsassistenten, um die Web-Server-Plug-ins und den erforderlichen vorläufigen Fix zu installieren.
  4. Geben Sie die Installationsposition an, wenn Sie vom Assistenten dazu aufgefordert werden. Fahren Sie dann mit der Installation fort.

Multimedia Hinweis: Im Video Enabling IHS for Liberty Dynamic Routing wird gezeigt, wie IHS und Web Server Plug-in for WebSphere Application Server installiert werden und wie der vorläufige Fix für Dynamic Routing angewendet wird. [Transkript]

Informationen zu diesem Vorgang

Wenn Sie HTTP-Anforderungen mithilfe von Intelligent Management an einen Liberty-Verbund weiterleiten möchten, müssen Sie für mindestens einen Verbundcontroller eines Verbundes das Feature Dynamic Routing aktivieren.

Vorgehensweise

  1. Fügen Sie zum Aktivieren von Dynamic Routing in einem Controller den folgenden Code zum Tag featureManager in der Datei server.xml des Controllers hinzu.

    <feature>dynamicRouting-1.0</feature>

  2. Starten Sie alle Controller, für die das Feature "Dynamic Routing" aktiviert ist.
  3. Fügen Sie für einen der Controller den Befehl dynamicRouting setup aus, um die Keystore- und die Plug-in-Konfigurationsdateien zu generieren. Beispiel:
    ./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=passw0rd --keystorePassword=webAS --pluginInstallRoot=/opt/HTTPServer_Plugins/ --webServerNames=webserver1
    Weitere Informationen zu Befehlen für Dynamic Routing finden Sie unter Befehl für dynamisches Routing.
    Anmerkung: Stellen Sie sicher, dass eine Benutzerregistry den angegebenen Benutzernamen (d. h. den Wert des Arguments --user) enthält und dass diesem Benutzer eine Verwaltungsrolle zugewiesen ist.
  4. Kopieren Sie die generierten Dateien plugin-key.jks und plugin-cfg.xml in ein temporäres Verzeichnis auf dem Web-Server-Host.
  5. Führen Sie auf dem Web-Server-Host den (im IHS-Paket enthaltenen) Befehl gskcmd aus, um den Keystore in das CMS-Format zu konvertieren und das persönliche Zertifikat als Standard festzulegen. CMS ist das unterstützte Format für das WebSphere-Plug-in. Beispiel:
      gskcmd -keydb -convert -pw webAS -db /tmp/plugin-key.jks -old_format jks -target /tmp/plugin-key.kdb -new_format cms -stash
    gskcmd -cert -setdefault -pw <<Kennwort>> -db /tmp/plugin-key.kdb -label default
  6. Kopieren Sie die von gskcmd erstellten Dateien plugin-key.kdb, plugin-key.rdb und plugin-key.sth aus dem temporären Verzeichnis in das Verzeichnis <Wert des Arguments --pluginInstallRoot>/config/<Web-Server-Name>/.
  7. Kopieren Sie die Datei plugin-cfg.xml in das Verzeichnis, das in der Anweisung WebSpherePluginConfig der Datei httpd.conf von IBM HTTP Server (IHS) angegeben ist. Die Datei plugin-cfg.xml wird mit der Zeilengruppe <IntelligentManagement> generiert. Wenn Dynamic Routing in einem Verbund aktiviert ist, gibt es für jeden Verbundcontroller eine Zeilengruppe <Connector>.
    Beispiel:
    <IntelligentMangement>
     <Property name="webserverName" value="webServer1"/>
     <ConnectorCluster enabled="true" maxRetries="-1" name="default" retryInterval="60">
      <Property name="uri" value="/ibm/api/dynamicRouting"/>
      <Connector host="controller1.acme.com" port="9444" protocol="https">
      <Property name="keyring" value="/opt/HTTPServer_Plugins/config/webserver1/plugin-key.kdb"/>
     </Connector>
     </ConnectorCluster>
    </IntelligentManagement>
  8. Starten Sie den Web-Server und beginnen Sie mit der Weiterleitung zu der im Verbund installierten Anwendung.
    Optional kann das Tag <dynamicRouting> zur Datei server.xml des Controllers hinzugefügt werden, um <ConnectorCluster>-Eigenschaften wie maxRetries und retryInterval anzugeben. Beispiel:
    <dynamicRouting maxRetries="4" retryInterval="20" connectorClusterName="collective1"/>
     <TraceSpecification name="default" specification=":DEBUG"/>
    </dynamicRouting>
    Die generierte Datei plugin-cfg.xml sieht wie folgt aus:
    <IntelligentMangement>
     <TraceSpecification name="default" specification=":DEBUG"/>
      <Property name="webserverName" value="webServer1"/>
      <ConnectorCluster enabled="true" maxRetries="4" name="collective1" retryInterval="20">
      <Property name="uri" value="/ibm/api/dynamicRouting"/>
      <Connector host="controller1.acme.com" port="9444" protocol="https">
      <Property name="keyring" value="/opt/HTTPServer_Plugins/config/webServer1/plugin-key.kdb"/>
      </Connector>
     </ConnectorCluster>
    </IntelligentManagement>

Ergebnisse

Wenn das Feature Dynamic Routing aktiviert ist, kann Intelligent Management dynamisch HTTP-Anforderungen an Liberty-Verbünde weiterleiten.

Symbol das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 16.06.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_wve_enabledynrout
Dateiname: twlp_wve_enabledynrout.html