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

Befehl für dynamisches Routing

Die dynamicRouting-Befehlsaktionen setup, genPluginCfg und genKeystore werden verwendet, um die Plug-in-Konfigurationsdatei und die Keystore-Datei zu generieren. Die dynamicRouting-Befehlsaktion genPluginCfg wird nach jeder Erstkonfiguration verwendet, um die Datei plugin-cfg.xml erneut zu generieren, z. B. wenn das Feature Dynamic Routing für einen neuen Controller aktiviert oder ein neuer Web-Server hinzugefügt wird. Mit der dynamicRouting-Befehlsaktion genKeystore wird die Keystore-Datei generiert. Jede der dynamicRouting-Befehlsaktionen unterstützt die Onlinehilfe.

Die Befehle für das Feature Dynamic Routing lauten wie folgt:

setup

Der dynamicRouting-Befehl setup generiert einen Keystore im Format PKCS12 oder JKS sowie mindestens eine WebSphere-Plug-in-Konfigurationsdatei. Der Keystore enthält ein persönliches Zertifikat sowie die memberRoot- und controllerRoot-Unterzeichnerzertifikate, die eine sichere Kommunikation zwischen dem WebSphere-Plug-in und dem Dynamic-Routing-Service ermöglichen. Derselbe Keystore wird auch verwendet, um HTTPS-Anforderungen an Anwendungen in Liberty-Verbundmembern zu senden. Die Plug-in-Konfigurationsdatei enthält die Zeilengruppe <IntelligentManagement>, mit der Intelligent Management in einem WebSphere-Plug-in aktiviert wird. Die Zeilengruppe <IntelligentManagement> enthält eine Zeilengruppe <ConnectorCluster> für den Verbund. Die Zeilengruppe <ConnectorCluster> enthält eine Zeilengruppe <Connector> für jeden Controller mit aktiviertem Feature Dynamic Routing.

Wenn Sie Hilfe für den Befehl abrufen möchten, setzen Sie <Controllerstammverzeichnis>/bin/dynamicRouting help setup ab. Daraufhin wird Folgendes angezeigt:

Beschreibung

Der dynamicRouting-Befehl setup generiert einen Keystore mit einem persönlichen Zertifikat und Unterzeichnerzertifikaten, die für eine sichere Kommunikation zwischen dem Dynamic-Routing-Service und Clients erforderlich sind. Es wird auch eine WebSphere-Plug-in-Konfigurationsdatei mit der Zeilengruppe <IntelligentManagement> erstellt, die Intelligent Management im WebSphere-Plug-in aktiviert.

Syntax

dynamicRouting setup [Optionen]

Optionen

--host=Name
Erforderlich. Der Hostname des Zielverbundcontrollers.
--password=[Kennwort]
Erforderlich. Das Kennwort des Administrators für den Zielverbundcontroller. Wenn kein Wert definiert ist, werden Sie zur Eingabe aufgefordert.
--port=Nummer
Erforderlich. Die HTTPS-Portnummer des Zielverbundcontrollers.
--user=Name
Erforderlich. Der Administrator für den Zielverbundcontroller.
--pluginInstallRoot=Pfad
Erforderlich. Vollständig qualifizierter Pfad des Stammverzeichnisses mit dem WebSphere-Plug-in auf dem Web-Server-Host.
--webServerNames=Web-Server-Name[,Web-Server-Name1]
Erforderlich. Durch Kommas getrennte Namen von Web-Servern, für die eine WebSphere-Plug-in-Konfigurationsdatei generiert werden muss.
--keystorePassword=[Kennwort]
Erforderlich. Kennwort für den generierten Keystore. Bei Angabe ohne Wert werden Sie zur Eingabe eines Wertes aufgefordert.
--keystoreType=Typ
Optional. Der Typ des generierten Keystores. Der Standardtyp ist JKS. Gültige Werte sind JKS und PKCS12.
--certificateSubject=DN
Anmerkung: Diese Option wird ignoriert. Da die Generierung von Zertifikaten verbessert wurde, ist die Angabe eines Zertifikatsubjekts nicht mehr sinnvoll. Die Option wird verwaltet, sodass vorhandene Scripts, die den dynamicRouting-Befehl setup verwenden, nicht aktualisiert werden müssen.

SSL-Zertifikate können automatisch anerkannt werden, wenn Sie die JVM-Eigenschaft com.ibm.websphere.dynamicRouting.utility.autoAcceptCertificates auf true setzen.

Anmerkung: Der mit den Befehlen setup und genKeystore generierte Keystore hat das Format JKS oder PKCS12. Er muss in ein Verzeichnis auf der Web-Server-Maschine kopiert werden. Anschließend muss gskcmd ausgeführt werden, um den Keystore in einen Store im CMS-Format zu konvertieren. Die Datei mit dem Store im Format CMS (.kdb) muss in das Verzeichnis <Wert des Arguments --pluginInstallRoot>/config/<Web-Server-Name> verschoben werden. Die Dateien .rdb und .sth müssen ebenfalls in dieses Verzeichnis verschoben werden.

Nachfolgend sehen Sie die Ausgabe des Befehls, wenn er mit allen erforderlichen Argumenten ausgeführt wird:

./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=password --keystorePassword=keypass --pluginInstallRoot=/opt/HTTPServer_Plugins --webServerNames=webServer1,webServer2

WebSphere-Plug-in-Konfigurationsdateien für Web-Server webServer1, webServer2 werden generiert

Die Zertifikatkette für den Zielserver wird automatisch akzeptiert.
Registrierter Name des Zertifikats: CN=admin, OU=controller1, O=ibm, C=us

Die MBean-Anforderung an den Controller wurde erfolgreich ausgeführt.
Die WebSphere-Plug-in-Konfigurationsdateien plugin-cfg-webServer1.xml, plugin-cfg-webServer2.xml wurden erfolgreich generiert.
Keystore für Web-Server webServer1, webServer2 wird generiert
Die MBean-Anforderung an den Controller wurde erfolgreich ausgeführt.
Der Keystore plugin-key.jks wurde erfolgreich generiert.

Die WebSphere-Plug-in-Konfigurationsdateien plugin-cfg-webServer1.xml, plugin-cfg-webServer2.xml für die Web-Server webServer1, webServer2 wurden generiert.
Es wurde auch eine Keystore-Datei plugin-key.p12 generiert, die eine sichere Kommunikation zwischen dem Dynamic-Routing-Service und Clients ermöglicht.

Kopieren Sie die WebSphere-Plug-in-Konfigurationsdatei in das Verzeichnis, das mit der Anweisung WebSpherePluginConfig in der IBM HTTP-Server-Datei
"httpd.conf" angegeben wurde. Kopieren Sie die
Keystore-Datei "plugin-key.jks" in ein Verzeichnis auf dem Web-Server-Host und führen Sie den Befehl "gskcmd" aus, um den Keystore in das Format CMS zu konvertieren und das persönliche Zertifikat
als Standardzertifikat festzulegen.
Beispiel: 
gskcmd -keydb -convert -pw  <<password>> -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

Kopieren Sie die generierten Dateien /tmp/plugin-key.kdb, .sth, .rdb in das Verzeichnis /opt/HTTPServer_Plugins/config/webServer1. 

genPluginCfg

Mit dieser Aktion werden die Plug-in-Konfigurationsdateien generiert. Jede Plug-in-Konfigurationsdatei enthält die Zeilengruppe <IntelligentManagement>, die die Intelligent-Management-Features des Plug-ins aktiviert. Die Zeilengruppe <IntelligentManagement> enthält eine Zeilengruppe <ConnectorCluster> für den Verbund. Die Zeilengruppe <ConnectCluster> enthält eine Zeilengruppe <Connector> für jeden Controller mit aktiviertem Feature Dynamic Routing. Durch Kommata getrennte Namen von Web-Servern werden mit dem Argument --webServerNames angegeben. Wenn beispielsweise --webServerNames=webServer1,webServer2 angegeben ist, werden die Dateien plugin-cfg-webServer1.xml und plugin-cfg-webServer2.xml generiert.

Wenn Sie die Onlinehilfe abrufen möchten, setzen Sie <Controllerstammverzeichnis>/bin/dynamicRouting help genPluginCfg ab. Daraufhin wird Folgendes angezeigt:

Beschreibung

Generiert eine WebSphere-Plug-in-Konfigurationsdatei mit einer Zeilengruppe <IntelligentManagement>, die Intelligent Management im WebSphere-Plug-in aktiviert.

Syntax

dynamicRouting genPluginCfg [Optionen]

Optionen

--host=Name
Erforderlich. Der Hostname des Zielverbundcontrollers.
--password=[Kennwort]
Erforderlich. Das Kennwort des Administrators für den Zielverbundcontroller. Wenn kein Wert definiert ist, werden Sie zur Eingabe aufgefordert.
--port=Nummer
Erforderlich. Die HTTPS-Portnummer des Zielverbundcontrollers.
--user=Name
Erforderlich. Der Administrator für den Zielverbundcontroller.
--pluginInstallRoot=Pfad
Erforderlich. Vollständig qualifizierter Pfad des Stammverzeichnisses mit dem WebSphere-Plug-in auf dem Web-Server-Host.
--webServerNames=Web-Server-Name[,Web-Server-Name1]
Erforderlich. Durch Kommas getrennte Namen von Web-Servern, für die eine WebSphere-Plug-in-Konfigurationsdatei generiert werden muss.

SSL-Zertifikate werden automatisch anerkannt, wenn Sie die JVM-Eigenschaft com.ibm.websphere.dynamicRouting.utility.autoAcceptCertificates auf true setzen.

Nachfolgend sehen Sie die Ausgabe des Befehls, wenn er mit allen erforderlichen Argumenten ausgeführt wird:

./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=password --keystorePassword=keypass --pluginInstallRoot=/opt/HTTPServer_Plugins --webServerNames=webServer1,webServer2

Mit dieser Aktion werden die Plug-in-Konfigurationsdateien generiert.
 
WebSphere-Plug-in-Konfigurationsdatei für Web-Server webServer1 wird generiert

Die Zertifikatkette für den Zielserver wird automatisch akzeptiert.
Registrierter Name des Zertifikats: CN=admin, OU=controller1, O=ibm, C=us

Die MBean-Anforderung an den Controller wurde erfolgreich ausgeführt.
Die Datei /home/user1/Liberty/wlp/bin/plugin-cfg.xml ist vorhanden.
Sie wird in /home/user1/Liberty/wlp/bin/plugin-cfg.xml.old gespeichert.
Die WebSphere-Plug-in-Konfigurationsdatei plugin-cfg.xml wurde erfolgreich generiert.

Die WebSphere-Plug-in-Konfigurationsdatei plugin-cfg.xml für den Web-Server webServer1 wurde generiert.
Kopieren Sie die WebSphere-Plug-in-Konfigurationsdatei in das Verzeichnis, das mit der Anweisung WebSpherePluginConfig in der IBM HTTP-Server-Datei httpd.conf angegeben wurde. 

genKeystore

Mit dieser Aktion wird ein Keystore im Format PKCS12 oder JKS generiert. Geben Sie mit der Option --keystoreType das Keystore-Format an. Die Generierung des PKCS12-Keystores wird nur bei Verwendung von IBM Java unterstützt. Der Keystore enthält ein persönliches Zertifikat sowie die memberRoot- und controllerRoot-Unterzeichnerzertifikate, die eine sichere Kommunikation zwischen dem WebSphere-Plug-in und dem Dynamic-Routing-Service ermöglichen. Derselbe Keystore wird auch verwendet, um HTTPS-Anforderungen an Anwendungen in Liberty-Verbundmembern zu senden.

Wenn Sie die Onlinehilfe abrufen möchten, setzen Sie <Controllerstammverzeichnis>/bin/dynamicRouting help genKeystore ab. Daraufhin wird Folgendes angezeigt:

Beschreibung

Generiert einen Keystore mit einem persönlichen Zertifikat und Unterzeichnerzertifikaten, die für eine sichere Kommunikation zwischen dem Dynamic-Routing-Service und Clients erforderlich sind.

Syntax

dynamicRouting genKeystore [Optionen]

Optionen

--host=Name
Erforderlich. Der Hostname des Zielverbundcontrollers.
--password=[Kennwort]
Erforderlich. Das Kennwort des Administrators für den Zielverbundcontroller. Wenn kein Wert definiert ist, werden Sie zur Eingabe aufgefordert.
--port=Nummer
Erforderlich. Die HTTPS-Portnummer des Zielverbundcontrollers.
--user=Name
Ein Administrator für den Zielverbundcontroller (erforderlich)
--keystorePassword=[Kennwort]
Erforderlich. Kennwort für den generierten Keystore. Bei Angabe ohne Wert werden Sie zur Eingabe eines Wertes aufgefordert.
--keystoreType=Typ
Optional. Der Typ des generierten Keystores. Der Standardtyp ist JKS. Gültige Werte sind JKS und PKCS12.
--certificateSubject=DN
Anmerkung: Diese Option wird ignoriert. Da die Generierung von Zertifikaten verbessert wurde, ist die Angabe eines Zertifikatsubjekts nicht mehr sinnvoll. Die Option wird verwaltet, sodass vorhandene Scripts, die den dynamicRouting-Befehl genKeystore verwenden, nicht aktualisiert werden müssen.

SSL-Zertifikate werden automatisch anerkannt, wenn Sie die JVM-Eigenschaft com.ibm.websphere.dynamicRouting.utility.autoAcceptCertificates auf true setzen.

Nachfolgend sehen Sie die Ausgabe des Befehls, wenn er mit allen erforderlichen Argumenten ausgeführt wird:

./dynamicRouting genKeystore --port=9444 --host=contoller1.acme.com --user=admin --password=password --keystorePassword

Kennwort --keystorePassword eingeben:
Kennwort --keystorePassword erneut eingeben:

Die Zertifikatkette für den Zielserver wird automatisch akzeptiert.
Certificate subject DN: CN=admin, OU=mycontroller, O=ibm, C=us

Der Keystore wird generiert...
Die MBean-Anforderung an den Controller wurde erfolgreich ausgeführt.
Der Keystore plugin-key.jks wurde erfolgreich generiert.

Die Keystore-Datei plugin-key.jks, die die sichere Kommunikation zwischen dem Service für dynamisches Routing und den Clients ermöglicht,
wurde generiert. Wenn Sie Intelligent Management im WebSphere-Plug-in verwenden, kopieren Sie die Keystore-Datei plugin-key.jks in ein
Verzeichnis auf dem Web-Server-Host und führen Sie dann "gskcmd" aus, um den Keystore in das CMS-Format zu konvertieren und das
persönliche Zertifikat als Standardzertifikat festzulegen.
Beispiel: 
gskcmd -keydb -convert -pw  <<password>> -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

Kopieren Sie die generierten Dateien /tmp/plugin-key.kdb, .sth, .rdb in das in der WebSphere-Plug-in-Konfigurationsdatei angegebene Schlüsselringverzeichnis. 

Symbol das den Typ des Artikels anzeigt. Referenzartikel



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