Sie können die erforderlichen Ports für Server und Clients in einer
eXtreme-scale-Implementierung mit Befehlszeilenparametern, mit Eigenschaftendateien oder über das Programm konfigurieren.
Die meisten Beispiele in den folgenden Abschnitten beschreiben Befehlszeilenparameter für das Script
startOgServer.
Entsprechende Konfigurationsoptionen können auch in Eigenschaftendateien, über die integrierte
Server-API oder die Client-API definiert werden.
Vorgehensweise
- Starten Sie Katalogserviceendpunkte.
WebSphere eXtreme Scale verwendet IIOP für die Kommunikation zwischen Java Virtual Machines.
Die Katalogservice-JVMs sind die einzigen Prozesse, die die explizite Konfiguration von Ports für die
IIOP-Services und Gruppenservices erfordern.
Alle anderen Prozesse ordnen Ports dynamisch zu.
- Geben Sie Client- und Peer-Ports an. Der Client-Port und der Peer-Port werden für die Kommunikation zwischen Katalogservices in einer Katalogservicedomäne
verwendet.
Verwenden Sie die folgende Befehlszeilenoption, um den Client-Port und den Peer-Port anzugeben:
- -catalogServiceEndPoints <Servername:Hostname:Client-Port:Peer-Port>
- Verweist im Container auf den ORB-Host (Object Request Broker) und ORB-Port im Katalogservice.
Die Attribute sind wie folgt definiert:
- Servername
- Gibt einen Namen an, der den Prozess identifiziert, den Sie starten.
- Hostname
- Gibt den Hostnamen des Computers an, auf dem der Server gestartet wird.
- Client-Port
- Gibt den Port an, der für die Kommunikation mit dem Peerkatalogservice verwendet wird.
- Peer-Port
- Dieser Wert entspricht dem HA-Manager-Port. Er gibt den Port an, der für die Kommunikation mit dem Peerkatalogservice verwendet wird.
Im folgenden
Beispiel wird der Katalogserver "cs1" gestartet, der sich in derselben
Katalogservicedomäne wie die Server "cs2" und "cs3" befindet:
startOgServer.bat|sh cs1 -catalogServiceEndPoints
cs1:MyServer1.company.com:6601:6602,
cs2:MyServer2.company.com:6601:6602,
cs3:MyServer3.company.com:6601:6602
Die Katalogserviceendpunkte können auch mit der
Servereigenschaft catalogServiceEndPoints definiert werden.
- Setzen Sie den ORB-Listener-Port (Object Request Broker). Der ORB-Listener-Port (Object Request Broker) wird für die Kommunikation zwischen Katalogservices in einer
Katalogservicedomäne und für die Kommunikation zwischen Katalogservices und Container-Servern und Clients
verwendet.
Verwenden Sie die folgenden Befehlszeilenoptionen, um den Listener-Port und den Listener-Host anzugeben:
- -listenerHost <Hostname>
Gibt den Hostnamen an, an den der
Object Request Broker (ORB) für die Kommunikation mit Internet
Inter-ORB Protocol (IIOP) gebunden wird. Der Wert muss ein vollständig qualifizierter Domänenname oder eine IP-Adresse sein.
Wenn Ihre Konfiguration mehrere Netzkarten enthält, definieren Sie den Listener-Host und Listener-Port,
so dass der Object Request Broker in der JVM die IP-Adresse für die Bindung kennt.
Wenn Sie die zu verwendende IP-Adresse nicht kennen,
können Symptome wie Überschreitungen des Verbindungszeitlimits, ungewöhnliche
API-Fehler und Clients, die zu blockieren scheinen, auftreten.
Standardeinstellung: localhost
- -listenerPort <Port>
- Gibt die Portnummer an, an die der
Object Request Broker (ORB) gebunden wird. Diese Einstellung konfiguriert Container und Clients für
die Kommunikation mit dem Katalogservice über den ORB.
In WebSphere Application
Server wird der Listener-Port
von der Konfiguration des BOOTSTRAP_ADDRESS-Ports übernommen. Diese Eigenschaft gilt für den Container-Server und den Katalogservice.Standardeinstellung: 2809
Der Listener-Port und der Listener-Host können auch mit den
Servereigenschaften listenerHost
und listenerPort angegeben werden.
- Optional: Setzen Sie den JMX-Service-Port.
Der JMX-Service-Port wird für die Kommunikation über JMX-Clients verwendet. Verwenden Sie die folgende Befehlszeilenoption, um
den JMX-Service-Port anzugeben:
- -JMXServicePort <Port>
- Gibt die Nummer des Ports an, über den der
MBean-Server mit Java Management Extensions (JMX) kommuniziert. Die Eigenschaft
"JMXServicePort" gibt den Nicht-SSL-Port für JMX an.
Sie müssen für jede JVM in Ihrer Konfiguration eine andere Portnummer verwenden.
Wenn Sie JMX/RMI verwenden, geben Sie die Option JMXServicePort und die Portnummer explizit an, selbst wenn Sie den Standardportwert
verwenden möchten.
Diese Eigenschaft gilt für den Container-Server und den Katalogservice.
(Nur für eigenständige Umgebungen erforderlich.)
Standardeinstellung: 1099 for catalog servers
Der JMX-Service-Port kann auch mit der
Servereigenschaft JMXServicePort definiert werden.
- Optional: Setzen Sie den JMX-Connector-Port.
Der JMX-Connector-Port wird für die Kommunikation über JMX-Clients verwendet.
Verwenden Sie zur Angabe des JMX-Connector-Ports die folgende Befehlszeilenoption:
- -JMXConnectorPort <Port>
- Definiert den SSL-Port (Secure
Sockets Layer), an den der JMX-Service (Java Management
Extensions) gebunden wird.
Der JMX-Connector-Port kann auch mit der Servereigenschaft
JMXConnectorPort definiert werden.
- Setzen Sie den SSL-Port (Secure Socket Layer).
Wenn die Sicherheit aktiviert ist, ist auch ein SSL-Port erforderlich.
Verwenden Sie die folgende Befehlszeilenoption, um den SSL-Port anzugeben:
-jvmArgs -Dcom.ibm.CSI.SSLPort=<SSL-Port>
Abbildung 1. Beispiel für die Verwendung der Befehlszeile.
Starten Sie den ersten Katalogserver auf hostA. Im Folgenden sehen Sie einen Beispielbefehl:./startOgServer.sh cs1 -listenerHost hostA -listenerPort 2809
-catalogServiceEndPoints cs1:hostA:6601:6611,cs2:hostB:6601:6611
Starten Sie den zweiten Katalogserver auf hostB.
Im Folgenden sehen Sie einen Beispielbefehl:
./startOgServer.sh cs2 -listenerHost hostB -listenerPort 2809
-catalogServiceEndPoints cs1:hostA:6601:6611,cs2:hostB:6601:6611
- Container-Server-Endpunkte starten.
Der folgende Befehl startet eine Container-JVM für den Beispielkatalogservice:
./startOgServer.sh
c0 -catalogServiceEndPoints hostA:2809,hostB:2809
Die Java Virtual
Machines des Container-Servers verwendet zwei Ports.
Der HA-Manager-Port wird für die interne Kommunikation zwischen Peer-Container-Servern und Katalogservern verwendet.
Der Listener-Port wird für die IIOP-Kommunikation zwischen Peer-Container-Servern, Katalogservern und Clients verwendet.
Der Listener-Port wird verwendet, um den ORB an einen bestimmten Netzadapter zu binden.
Wenn Sie keine Ports angeben, werden beide Ports dynamisch ausgewählt.
Möchten Sie die Ports jedoch explizit konfigurieren, wie z. B. in einer Firewallumgebung,
können Sie den ORB-Port mithilfe von Befehlszeilenoptionen
angeben.
- Geben Sie den Listener-Host und -Port an. Verwenden Sie die folgenden Befehlszeilenoptionen, um den Listener-Port und den Listener-Host anzugeben:
- -listenerHost <Hostname>
Gibt den Hostnamen an, an den der
Object Request Broker (ORB) für die Kommunikation mit Internet
Inter-ORB Protocol (IIOP) gebunden wird. Der Wert muss ein vollständig qualifizierter Domänenname oder eine IP-Adresse sein.
Wenn Ihre Konfiguration mehrere Netzkarten enthält, definieren Sie den Listener-Host und Listener-Port,
so dass der Object Request Broker in der JVM die IP-Adresse für die Bindung kennt.
Wenn Sie die zu verwendende IP-Adresse nicht kennen,
können Symptome wie Überschreitungen des Verbindungszeitlimits, ungewöhnliche
API-Fehler und Clients, die zu blockieren scheinen, auftreten.
Standardeinstellung: localhost
- -listenerPort <Port>
- Gibt die Portnummer an, an die der
Object Request Broker (ORB) gebunden wird. Diese Einstellung konfiguriert Container und Clients für
die Kommunikation mit dem Katalogservice über den ORB.
In WebSphere Application
Server wird der Listener-Port
von der Konfiguration des BOOTSTRAP_ADDRESS-Ports übernommen. Diese Eigenschaft gilt für den Container-Server und den Katalogservice.Standardeinstellung: 2809
Der Listener-Port und der Listener-Host können auch mit den
Servereigenschaften listenerHost
und listenerPort angegeben werden.
- Geben Sie den HA-Manager-Port an. Verwenden Sie die folgende Befehlszeilenoption, um
den HA-Manager-Port anzugeben:
- -haManagerPort <Port>
- Gibt die Nummer des vom High Availability Manager verwendeten Ports an.
Wenn diese Eigenschaft nicht gesetzt wird, wird ein freier Port ausgewählt.
Diese Eigenschaft wird in Umgebungen von WebSphere Application
Server ignoriert.
Der HA-Manager-Port kann auch mit der
Servereigenschaft HAManagerPort definiert werden.
- Optional: Geben Sie den SSL-Port an.
Wenn die Sicherheit aktiviert ist, ist auch ein SSL-Port (Secure Socket Layer) erforderlich.
Verwenden Sie die folgende Befehlszeilenoption, um den SSL-Port anzugeben:
-jvmArgs -Dcom.ibm.CSI.SSLPort=<SSL-Port>
- Optional: Geben Sie den JMX-Service-Port an.
- -JMXServicePort <Port>
- Gibt die Nummer des Ports an, über den der
MBean-Server mit Java Management Extensions (JMX) kommuniziert. Die Eigenschaft
"JMXServicePort" gibt den Nicht-SSL-Port für JMX an.
Sie müssen für jede JVM in Ihrer Konfiguration eine andere Portnummer verwenden.
Wenn Sie JMX/RMI verwenden, geben Sie die Option JMXServicePort und die Portnummer explizit an, selbst wenn Sie den Standardportwert
verwenden möchten.
Diese Eigenschaft gilt für den Container-Server und den Katalogservice.
(Nur für eigenständige Umgebungen erforderlich.)
Standardeinstellung: 1099 for catalog servers
Der JMX-Service-Port kann auch mit der
Servereigenschaft JMXServicePort definiert werden.
- Optional: Setzen Sie den JMX-Connector-Port.
Der JMX-Connector-Port wird für die Kommunikation über JMX-Clients verwendet.
Verwenden Sie zur Angabe des JMX-Connector-Ports die folgende Befehlszeilenoption:
- -JMXConnectorPort <Port>
- Definiert den SSL-Port (Secure
Sockets Layer), an den der JMX-Service (Java Management
Extensions) gebunden wird.
Der JMX-Connector-Port kann auch mit der Servereigenschaft
JMXConnectorPort definiert werden.
- Clientendpunkte starten.
Clients müssen nur die Listenerendpunkte des Katalogservice kennen.
Clients
rufen Endpunkte für Container-Server-JVMs,
die die JVMs sind, die die Daten enthalten, automatisch vom Katalogservice ab.
Um eine Verbindung zu dem Katalogservice aus dem vorherigen Beispiel
herzustellen, muss der Client die folgende Liste von
Host:Port-Paaren an die API "connect" übergeben:
hostA:2809,hostB:2809
Der Client kann auch Callbacks von Container-Servern empfangen, wenn die
API "DataGrid" verwendet wird.
Diese Callbacks kommunizieren über IIOP mit dem ORB-Listener-Port.
Wenn Sie festlegen möchten, dass der Port und der Netzadapter Callbacks empfangen,
definieren Sie die Eigenschaften listenerHost und listenerPort in der
Clienteigenschaftendatei.
Wenn die Sicherheit aktiviert ist, ist auch ein SSL-Port (Secure Socket Layer) erforderlich.
Verwenden Sie die folgende Systemeigenschaft beim Starten des Clientprozesses, um den SSL-Port anzugeben:
-jvmArgs -Dcom.ibm.CSI.SSLPort=<SSL-Port>