Das Script startOgServer startet Container- und Katalogserver.
Sie können beim Starten Ihrer Server eine Vielzahl von Parametern
verwenden, um die Traceerstellung zu aktivieren, Portnummern anzugeben usw.
Zweck
Sie können das Script startOgServer verwenden, um Server zu starten.
Position
Sie finden das Script
startOgServer im Verzeichnis
bin des Stammverzeichnisses, z. B.:
cd WXS-Installationsstammverzeichnis/bin
Anmerkung: Wenn Sie Java-Klassen haben, die in einem bestimmten Verzeichnis gespeichert sind, oder ein Ladeprogramm
oder Agenten verwenden, können Sie
den Server wie folgt mit Argumenten starten, anstatt das Script "startOgServer" zu ändern:
-jvmArgs -cp C:\ . . . . \DirectoryPOJOs\POJOs.jar
.
Optionen für das Starten von Katalogservern
Die folgenden Parameter sind alle
optional.
Parameter für das Starten eines Katalogservers:- -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
- -clusterSecurityFile <XML-Sicherheitsdatei des Clusters>
- Gibt die Datei objectGridSecurity.xml auf der Festplatte an, die die Sicherheitseigenschaften
beschreibt, die allen Servern (einschließlich Katalogservern und Container-Servern) gemein sind.
Ein Beispiel für eine solche Eigenschaft ist die Authentifikatorkonfiguration, die die Benutzerregistry und das Authentifizierungsverfahren
darstellt.
Beispiel:/opt/xs/ogsecurity.xml
- -clusterSecurityUrl <URL der Sicherheits-XML des Clusters>
- Gibt die Datei objectGridSecurity.xml als URL
zur Datei auf der Festplatte bzw. im Netz an, die die Sicherheitseigenschaften
beschreibt, die allen Servern (einschließlich Katalogservern und Container-Servern) gemein sind.
Ein Beispiel für eine solche Eigenschaft ist die Authentifikatorkonfiguration, die die Benutzerregistry und das Authentifizierungsverfahren
darstellt.
Beispiel: file:///opt/xs/ogsecurity.xml
- -domain <Domänenname>
- Gibt den Namen der Katalogservicedomäne für diesen Katalogserver an.
Die Katalogservicedomäne erstellt eine Gruppe hoch verfügbarer
Katalogserver.
Jeder Katalogserver für eine Domäne muss denselben Wert für den Parameter
-domain angeben.
- -JMXConnectorPort <Port>
- Definiert den SSL-Port (Secure
Sockets Layer), an den der JMX-Service (Java Management
Extensions) gebunden wird.
- -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.
- -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
- -jvmArgs <JVM-Argumente>
- Gibt eine Gruppe von JVM-Argumenten an. Alle Optionen hinter der Option -jvmArgs
werden verwendet, um die Server-JVM zu starten.
Wenn der Parameter -jvmArgs verwendet wird, müssen Sie sicherstellen, dass er das letzte optionale
Scriptargument ist, das angegeben wird.
Beispiel:-jvmArgs -Xms256M
-Xmx1G
- -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
- -quorum true|false
Aktiviert das Quorum für den Katalogservice.
Das Quorum wird verwendet, um sicherzustellen, dass die Mehrheit der Member der Katalogservicedomäne
verfügbar ist, bevor Partitionen in die verfügbaren Container-Server verschoben werden.
Zum Aktivieren des Quorums setzen Sie die Eigenschaft auf
true oder enabled.
Der Standardwert ist disabled. Diese Eigenschaft
gilt nur für den Katalogservice.
Weitere Informationen finden Sie unter Katalogserverquorum.
- -script <Scriptdatei>
- Gibt die Position eines angepasstesn Script für Befehle an, die Sie angeben, um Katalogserver oder -container zu starten
und dann wie gewünscht zu parametrisieren oder zu bearbeiten.
- -serverProps <Servereigenschaftendatei>
- Gibt die Servereigenschaftendatei an, die die serverspezifischen Sicherheitseigenschaften enthält.
Der Dateiname für diese Eigenschaft kann im herkömmlichen Dateipfadformat angegeben werden, z. B.
c:/tmp/og/catalogserver.props.
- -traceSpec <Tracespezifikation>
Aktiviert die Traceerstellung und die Tracespezifikationszeichenfolge
für den Container-Server.
Die Traceerstellung ist standardmäßig inaktiviert. Diese Eigenschaft gilt für den Container-Server und den Katalogservice.
Beispiele:
- ObjectGrid=all=enabled
- ObjectGrid*=all=enabled
- -traceFile <Tracedatei>
Gibt den Namen einer Datei an, in die Traceinformationen geschrieben werden sollen. Diese Eigenschaft gilt für den Container-Server und den Katalogservice.
Beispiel: ../logs/c4Trace.log
- -timeout <Sekunden>
- Gibt das Zeitlimit (in Sekunden) für den Serverstart an.
Syntax für Container-Server
startOgServer.bat <Server> -objectgridFile <XML-Datei>
-deploymentPolicyFile <XML-Datei> [Optionen]
startOgServer.bat <Server> -objectgridUrl <XML-URL>
-deploymentPolicyUrl <XML-URL> [Optionen]
startOgServer.sh <Server> -objectgridFile <XML-Datei>
-deploymentPolicyFile <XML-Datei> [Optionen]
startOgServer.sh <Server> -objectgridUrl <XML-URL>
-deploymentPolicyUrl <XML-URL> [Optionen]
Optionen für Container-Server
- -catalogServiceEndPoints<Hostname:Port,Hostname:Port>
- Gibt den ORB-Host und ORB-Port im Katalogservice an.
Standardeinstellung: localhost:2809
- -deploymentPolicyFile <XML-Datei_für_Implementierungsrichtlinien>
- Gibt den Pfad der Implementierungsrichtliniendatei auf der Festplatte
an. Die Implementierungsrichtlinie wird für die Konfiguration der Partitionierung und der Replikation verwendet.
Die Implementierungsrichtlinie kann auch verwendet werden,
um das Verteilungsverhalten zu beeinflussen.
Beispiel: ../xml/SimpleDP.xml
- -deploymentPolicyUrl <URL_der_Implementierungsrichtlinie>
- Gibt den URL für die Implementierungsrichtliniendatei auf der Festplatte bzw. im Netz an.
Die Implementierungsrichtlinie wird für die Konfiguration der Partitionierung und der Replikation verwendet.
Die Implementierungsrichtlinie kann auch verwendet werden,
um das Verteilungsverhalten zu beeinflussen.
Beispiel: file://xml/SimpleDP.xml
- -JMXConnectorPort <Port>
- Definiert den SSL-Port (Secure
Sockets Layer), an den der JMX-Service (Java Management
Extensions) gebunden wird.
- -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
- -jvmArgs <JVM-Argumente>
- Gibt eine Gruppe von JVM-Argumenten an. Alle Optionen hinter der Option -jvmArgs
werden verwendet, um die Server-JVM zu starten.
Wenn der Parameter -jvmArgs verwendet wird, müssen Sie sicherstellen, dass er das letzte optionale
Scriptargument ist, das angegeben wird.
Beispiel:-jvmArgs -Xms256M
-Xmx1G
- -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
- -objectgridFile <ObjectGrid-XML-Deskriptordatei>
- Gibt den Pfad der ObjectGrid-Deskriptordatei an. Die ObjectGrid-XML-Datei gibt an, welche eXtreme-Scale-Server der Container hostet.
- -objectgridUrl <URL_des_ObjectGrid-Deskriptors>
- Gibt einen URL für die ObjectGrid-Deskriptordatei an. Die ObjectGrid-XML-Datei gibt an, welche eXtreme-Scale-Server der Container hostet.
- -script <Scriptdatei>
- Gibt die Position eines angepasstesn Script für Befehle an, die Sie angeben, um Katalogserver oder -container zu starten
und dann wie gewünscht zu parametrisieren oder zu bearbeiten.
- -serverProps <Servereigenschaftendatei>
- Gibt den Pfad der Servereigenschaftendatei an.
Beispiel:../security/server.props
- -timeout <Sekunden>
- Gibt das Zeitlimit (in Sekunden) für den Serverstart an.
- -traceFile <Tracedatei>
Gibt den Namen einer Datei an, in die Traceinformationen geschrieben werden sollen. Diese Eigenschaft gilt für den Container-Server und den Katalogservice.
Beispiel: ../logs/c4Trace.log
- -traceSpec <Tracespezifikation>
Aktiviert die Traceerstellung und die Tracespezifikationszeichenfolge
für den Container-Server.
Die Traceerstellung ist standardmäßig inaktiviert. Diese Eigenschaft gilt für den Container-Server und den Katalogservice.
Beispiele:
- ObjectGrid=all=enabled
- ObjectGrid*=all=enabled
- -zone <Zonenname>
- Gibt die für alle Container im Server zu verwendende Zone an.
Weitere Informationen zum Konfigurieren von Zonen finden Sie in Routing an bevorzugte Zonen .