Script startOgServer

Le script startOgServer arrête les serveurs de catalogue et de conteneur. Vous pouvez utiliser divers paramètres lorsque vous démarrez vos serveurs pour activer la trace, spécifiez des numéros de port, etc.

Rôle

Vous pouvez utiliser le script startOgServer pour démarrer les serveurs.

Placement

Le script startOgServer se trouve dans le répertoire bin du répertoire root, par exemple :
cd racine_install_wxs/bin
Remarque : Si vous avez des classes Java stockées dans un répertoire spécifique, ou si vous utilisez un chargeur ou un agent, au lieu de modifier le script startOgServer, vous pouvez lancer le serveur avec des arguments, comme suit : -jvmArgs -cp C:\ . . . \DirectoryPOJOs\POJOs.jar
.

Syntaxe des serveurs de catalogue

Pour démarrer un serveur de catalogue :

[Windows]
startOgServer.bat <server> [options]
[Unix]
startOgServer.sh <server>[options]
Pour démarrer un serveur de catalogues configuré par défaut, utilisez les commandes suivantes :
[Windows]
startOgServer.bat catalogServer
[Unix]
startOgServer.sh catalogServer

Options de démarrage des serveurs de catalogue

Les paramètres suivants sont tous facultatifs.

Paramètres de démarrage d'un serveur de catalogues :
-catalogServiceEndPoints <serverName:hostName:clientPort:peerPort>
Dans le conteneur, fait référence à l'hôte et au port ORB (Object Request Broker) dans le service de catalogue. Chaque attribut est défini comme suit :
serverName
Spécifie un nom permettant d'identifier le processus que vous lancez.
hostName
Spécifie le nom d'hôte de l'ordinateur sur lequel le serveur est lancé.
clientPort
Spécifie le port utilisé pour la communication de service de catalogue homologue.
peerPort
Cette value est identique à haManagerPort. Spécifie le port utilisé pour la communication de service de catalogue homologue.
L'exemple suivant démarre le serveur de catalogue, cs1, qui se trouve dans le même domaine de service de catalogue que les serveurs cs2 et cs3 :
startOgServer.bat|sh cs1 -catalogServiceEndPoints 
cs1:MyServer1.company.com:6601:6602,
cs2:MyServer2.company.com:6601:6602,
cs3:MyServer3.company.com:6601:6602
-clusterSecurityFile <fichier_xml_sécurité_cluster>
Indique le fichier objectGridSecurity.xml sur le disque dur, qui décrit les propriétés de sécurité communes à tous les serveurs (y compris les serveurs de catalogue et les serveurs de conteneur). L'un des exemples de propriété est la configuration de l'authentificateur qui représente le registre d'utilisateurs et le mécanisme d'authentification.

Exemple :/opt/xs/ogsecurity.xml

-clusterSecurityUrl <URL du xml de la sécurité du cluster>
Indique le fichier objectGridSecurity.xml comme URL du fichier sur le disque dur ou sur le réseau, qui décrit les propriétés de sécurité communes à tous les serveurs, y compris les serveurs de catalogue et les serveurs de conteneur. L'un des exemples de propriété est la configuration de l'authentificateur qui représente le registre d'utilisateurs et le mécanisme d'authentification.

Exemple :file:///opt/xs/ogsecurity.xml

-domain <nom de domaine>
Indique le nom du domaine de service de catalogue du serveur de catalogue. Le domaine de service de catalogue crée un groupe de serveurs de catalogue à haute disponibilité. Chaque serveur de catalogue pour un seul domaine doit spécifier la même valeur pour le paramètre -domain.
-JMXConnectorPort <port>
Définit le port SSL (Secure Sockets Layer) auquel se connecte le service Java Management Extensions (JMX).
-haManagerPort <port>
Indique le numéro de port utilisé par le gestionnaire de haute disponibilité. Si cette propriété n'est pas définie, un port libre est choisi. Cette propriété est ignorée dans les environnements WebSphere Application Server.
-JMXServicePort <port>
Spécifie le numéro du port sur lequel le serveur MBean écoute les communications avec Java Management Extensions (JMX). La propriété JMXServicePort indique le port non SSL pour JMX. Vous devez utiliser un numéro de port différent pour chaque machine virtuelle Java dans votre configuration. Si vous voulez utiliser JMX/RMI, définissez explicitement l'option -JMXServicePort et le numéro de port, même si vous souhaitez utiliser la valeur de port par défaut. Cette propriété s'applique à la fois au serveur de conteneur et au service de catalogue. (Requis pour les environnements autonomes uniquement.)

Valeur par défaut : 1099 pour les serveurs de catalogue

-jvmArgs <arguments de la machine virtuelle Java>
Indique un ensemble d'arguments de machine virtuelle Java. Chaque option après l'option -jvmArgs est utilisée pour démarrer la machine JVM (Java virtual machine) du serveur. Si le paramètre -jvmArgs est utilisé, vérifiez qu'il s'agit du dernier argument de script facultatif spécifié.

Exemple :-jvmArgs -Xms256M -Xmx1G

-listenerHost <nom d'hôte>

Indique le nom d'hôte auquel l'ORB (Object Request Broker) se connecte pour communiquer avec IIOP (Internet Inter-ORB Protocol). La valeur doit être un nom qualifié complet de domaine ou une adresse IP. Si la configuration implique plusieurs cartes réseau, configurez l'hôte du programme d'écoute et le port d'écoute pour que l'ORB (Object Request Broker) dans la machine JVM connaisse l'adresse IP à laquelle se connecter. Si vous ne définissez pas l'adresse IP à utiliser, des symptômes (délais de connexion, défaillances inhabituelles d'API et clients qui semblent se bloquer) apparaissent.

Valeur par défaut : localhost
-listenerPort <port>
Indique le numéro de port auquel se connecte l'ORB (Object Request Broker). Ce paramètre configure les conteneurs et les clients pour communiquer avec le service de catalogue via l'ORB. Dans WebSphere Application Server, le port d'écoute est hérité par la configuration de port BOOTSTRAP_ADDRESS. Cette propriété s'applique au serveur de conteneur et au service de catalogue.Valeur par défaut : 2809
-quorum true|false

Active le quorum pour le service de catalogue. Le quorum sert à garantir qu'une majorité du domaine de service de catalogue est disponible avant le déplacement des partitions sur les serveurs de conteneur disponibles. Pour activer le quorum, spécifiez la valeur true ou enabled. La valeur par défaut est disabled. Cette valeur s'applique au service de catalogue uniquement. Pour plus d'informations, voir Quorums de serveurs de catalogue.

-script <fichier script>
Indique l'emplacement d'un script personnalisé pour les commandes que vous spécifiez pour démarrer les serveurs de catalogue ou les conteneurs, puis définir des paramètres ou effectuer des modifications en fonction des besoins.
-serverProps <fichier de propriétés du serveur>
Indique le fichier de propriétés du serveur qui contient les propriétés de sécurité spécifiques au serveur. Le nom de fichier spécifié pour cette propriété correspond simplement à un chemin classique, tel que c:/tmp/og/catalogserver.props.
-traceSpec <spécification de la trace>
Active la trace et la chaîne de spécification de trace du serveur de conteneur. La trace est désactivée par défaut. Cette propriété s'applique à la fois au serveur de conteneur et au service de catalogue. Exemples :
  • ObjectGrid=all=enabled
  • ObjectGrid*=all=enabled
-traceFile <fichier de trace>

Indique le nom du fichier dans lequel les informations de trace seront consignées. Cette propriété s'applique à la fois au serveur de conteneur et au service de catalogue. Exemple : ../logs/c4Trace.log

-timeout <secondes>
Indique un nombre de secondes avant que le démarrage du serveur n'arrive à expiration.

Syntaxe des serveurs de conteneur

[Windows]
startOgServer.bat <serveur> -objectgridFile <fichier xml> 
-deploymentPolicyFile <fichier xml> [options] 
[Windows]
startOgServer.bat <serveur> -objectgridUrl <URL du xml> 
-deploymentPolicyUrl <URL du xml> [options]
[Unix]
startOgServer.sh <server> -objectgridFile <fichier xml> 
-deploymentPolicyFile <fichier xml> [options]
[Unix]
 startOgServer.sh <serveur> -objectgridUrl <URL du xml> 
-deploymentPolicyUrl <URL du xml> [options]

Options des serveurs de conteneur

-catalogServiceEndPoints<nomHôte:port,nomHôte:port>
Spécifie l'hôte ORB (Object Request Broker) et le numéro de port dans le service de catalogue.

Valeur par défaut : localhost:2809

-deploymentPolicyFile <fichier xml de la règle de déploiement>
Indique le chemin d'accès au fichier de la stratégie de déploiement sur le disque dur. La stratégie de déploiement est utilisée pour configurer le partitionnement et la réplication. La règle de déploiement peut également être utilisée pour influencer le comportement de positionnement.

Exemple : ../xml/SimpleDP.xml

-deploymentPolicyUrl <url de la règle de déploiement>
Indique l'URL du fichier de la stratégie de déploiement sur le disque dur ou sur le réseau. La stratégie de déploiement est utilisée pour configurer le partitionnement et la réplication. La règle de déploiement peut également être utilisée pour influencer le comportement de positionnement.

Exemple : file://xml/SimpleDP.xml

-JMXConnectorPort <port>
Définit le port SSL (Secure Sockets Layer) auquel se connecte le service Java Management Extensions (JMX).
-JMXServicePort <port>

Spécifie le numéro du port sur lequel le serveur MBean écoute les communications avec Java Management Extensions (JMX). La propriété JMXServicePort indique le port non SSL pour JMX. Vous devez utiliser un numéro de port différent pour chaque machine virtuelle Java dans votre configuration. Si vous voulez utiliser JMX/RMI, définissez explicitement l'option -JMXServicePort et le numéro de port, même si vous souhaitez utiliser la valeur de port par défaut. Cette propriété s'applique à la fois au serveur de conteneur et au service de catalogue. (Requis pour les environnements autonomes uniquement.)

Valeur par défaut : 1099
-jvmArgs <arguments de la machine virtuelle Java>
Indique un ensemble d'arguments de machine virtuelle Java. Chaque option après l'option -jvmArgs est utilisée pour démarrer la machine JVM (Java virtual machine) du serveur. Si le paramètre -jvmArgs est utilisé, vérifiez qu'il s'agit du dernier argument de script facultatif spécifié.

Exemple :-jvmArgs -Xms256M -Xmx1G

-listenerHost <nom d'hôte>

Indique le nom d'hôte auquel l'ORB (Object Request Broker) se connecte pour communiquer avec IIOP (Internet Inter-ORB Protocol). La valeur doit être un nom qualifié complet de domaine ou une adresse IP. Si la configuration implique plusieurs cartes réseau, configurez l'hôte du programme d'écoute et le port d'écoute pour que l'ORB (Object Request Broker) dans la machine JVM connaisse l'adresse IP à laquelle se connecter. Si vous ne définissez pas l'adresse IP à utiliser, des symptômes (délais de connexion, défaillances inhabituelles d'API et clients qui semblent se bloquer) apparaissent.

Valeur par défaut : localhost
-listenerPort <port>
Indique le numéro de port auquel se connecte l'ORB (Object Request Broker). Ce paramètre configure les conteneurs et les clients pour communiquer avec le service de catalogue via l'ORB. Dans WebSphere Application Server, le port d'écoute est hérité par la configuration de port BOOTSTRAP_ADDRESS. Cette propriété s'applique au serveur de conteneur et au service de catalogue.Valeur par défaut : 2809
-objectgridFile <Fichier XML du descripteur d'ObjectGrid>
Indique le chemin d'accès au fichier du descripteur d'ObjectGrid. Le fichier XML ObjectGrid spécifie les serveurs eXtreme Scale hébergés par le conteneur.
-objectgridUrl <URL du descripteur d'ObjectGrid>
Spécifie une URL pour le fichier descripteur ObjectGrid. Le fichier XML ObjectGrid spécifie les serveurs eXtreme Scale hébergés par le conteneur.
-script <fichier script>
Indique l'emplacement d'un script personnalisé pour les commandes que vous spécifiez pour démarrer les serveurs de catalogue ou les conteneurs, puis définir des paramètres ou effectuer des modifications en fonction des besoins.
-serverProps <fichier de propriétés du serveur>
Indique le chemin d'accès au fichier de propriétés du serveur.

Exemple :../security/server.props

-timeout <secondes>
Indique un nombre de secondes avant que le démarrage du serveur n'arrive à expiration.
-traceFile <fichier de trace>

Indique le nom du fichier dans lequel les informations de trace seront consignées. Cette propriété s'applique à la fois au serveur de conteneur et au service de catalogue. Exemple : ../logs/c4Trace.log

-traceSpec <spécification de la trace>
Active la trace et la chaîne de spécification de trace du serveur de conteneur. La trace est désactivée par défaut. Cette propriété s'applique à la fois au serveur de conteneur et au service de catalogue. Exemples :
  • ObjectGrid=all=enabled
  • ObjectGrid*=all=enabled
-zone <nom de zone>
Indique la zone à utiliser pour tous les conteneurs du serveur. Voir les Routage par zone préférée pour plus d'informations sur la configuration de zones.