Script startOgServer

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
.

Syntax für Katalogserver

Verwenden Sie zum Starten eines Katalogservers die folgenden Befehle:

[Windows]
startOgServer.bat <Server> [Optionen]
[Unix]
startOgServer.sh <Server> [Optionen]
Verwenden Sie zum Starten des konfigurierten Standardkatalogservers die folgenden Befehle:
[Windows]
startOgServer.bat catalogServer
[Unix]
startOgServer.sh catalogServer

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

[Windows]
startOgServer.bat <Server> -objectgridFile <XML-Datei>
-deploymentPolicyFile <XML-Datei> [Optionen] 
[Windows]
startOgServer.bat <Server> -objectgridUrl <XML-URL>
-deploymentPolicyUrl <XML-URL> [Optionen]
[Unix]
startOgServer.sh <Server> -objectgridFile <XML-Datei>
-deploymentPolicyFile <XML-Datei> [Optionen]
[Unix]
 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 .