Configuration de ports en mode autonome

Vous pouvez configurer les ports nécessaires pour les serveurs et les clients dans un déploiement eXtreme Scale à l'aide de paramètres de ligne de commande, de fichiers de propriétés ou à l'aide d'un programme. La plupart des exemples dans les sections suivantes décrivent les paramètres de ligne de commande dans le script startOgServer. Des options de configuration équivalentes peuvent être également définies dans des fichiers de propriétés, à l'aide de l'API de serveur embarqué ou l'API client.

Procédure

  1. Démarrez les noeuds finals du service de catalogue.

    WebSphere eXtreme Scale utilise IIOP pour la communication entre les machines virtuelles Java. Les machines virtuelles Java de service de catalogue sont les seuls processus qui requièrent la configuration explicite de ports pour les services IIOP et de ports des services de groupe. Les autres processus d'allouer dynamiquement les ports.

    1. Spécifiez les ports client et homologue. Le port du client et le port homologue sont utilisés pour la communication entre les services de catalogue dans un domaine de service de catalogue. Pour indiquer le port client et le port homologue, utilisez l'option de ligne de commande suivante :
      -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
      Les noeud finals de service de catalogue peuvent être également définis à l'aide de la propriété de serveur de catalogue catalogClusterEndPoints.
    2. Définissez le port d'écoute ORB (Object Request Broker). Le port d'écoute ORB (Object Request Broker) est utilisé pour la communication entre les services de catalogue dans un domaine de service de catalogue et pour la communication entre les services de catalogue et les serveurs de conteneur et les clients. Pour indiquer le port d'écoute et l'hôte d'écoute, utilisez les options de ligne de commande suivantes :
      -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

      Le port d'écoute et l'hôte d'écoute peuvent être également définis à l'aide des propriétés listenerHost et listenerPort.

    3. Facultatif : Définissez le port de service JMX.

      Le port de service JMX est utilisé pour la communication entre les clients JMX. Pour indiquer le port de service JMX, utilisez l'option de ligne de commande suivante :

      -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

      Le port de service JMX peut être également défini à l'aide de la propriété de serveur JMXServicePort.

    4. Facultatif : Définissez le port de connecteur JMX.

      Le port de connecteur JMX est utilisé pour la communication entre les clients JMX. Pour indiquer le port de connecteur JMX, utilisez l'option de ligne de commande suivante :

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

      Le port de connecteur JMX peut être également défini à l'aide de la propriété de serveur JMXConnectorPort.

    5. Définissez le port SSL (Secure Socket Layer).
      Lorsque la sécurité est activée, un port SSL (Secure Socket Layer) est aussi nécessaire. Pour indiquer le port SSL, utilisez l'option de ligne de commande suivante :
      -jvmArgs -Dcom.ibm.CSI.SSLPort=<sslPort>
    Figure 1. Exemple d'utilisation de ligne de commande. Démarrez le premier serveur de catalogues sur hostA. Exemple de commande :
    ./startOgServer.sh cs1 -listenerHost hostA -listenerPort 2809
    -catalogServiceEndPoints cs1:hostA:6601:6611,cs2:hostB:6601:6611
    Démarrez le second serveur de catalogues sur hostB. Exemple de commande :
    ./startOgServer.sh cs2 -listenerHost hostB -listenerPort 2809
    -catalogServiceEndPoints cs1:hostA:6601:6611,cs2:hostB:6601:6611
  2. Démarrez les noeuds finals de serveur de conteneur.

    La commande suivante démarre une machine virtuelle Java de conteneur à utiliser avec l'exemple de service de catalogue :

    ./startOgServer.sh c0 -catalogServiceEndPoints hostA:2809,hostB:2809

    Le serveur de conteneur machines virtuelles Java utilise deux ports. Le port du gestionnaire haute disponibilité est utilisé pour les communications internes entre les serveurs de conteneur homologues et serveurs de catalogue. Le port d'écoute est utilisé pour les communications IIOP entre les serveurs de conteneur homologues, les serveurs de catalogue et les clients. L'hôte d'écoute est utilisé pour associer l'ORB à un adaptateur réseau spécifique. Si vous ne spécifiez rien, les deux ports sont dynamiquement sélectionnés. Toutefois, si vous souhaitez configurer les ports de manière explicite, comme dans un environnement de pare-feu, vous pouvez utiliser une option de ligne de commande pour spécifier le port ORB.

    1. Spécifiez le port d'écoute et l'hôte d'écoute. Pour indiquer le port d'écoute et l'hôte d'écoute, utilisez les options de ligne de commande suivantes :
      -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

      Le port d'écoute et l'hôte d'écoute peuvent être également définis à l'aide des propriétés listenerHost et listenerPort.

    2. Spécifiez le port du gestionnaire haute disponibilité. Pour indiquer le port du gestionnaire haute disponibilité, utilisez l'option de ligne de commande suivante :
      -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.

      Le port du gestionnaire haute disponibilité peut être également défini à l'aide de la propriété de serveur HAManagerPort.

    3. Facultatif : Spécifiez le port SSL.
      Lorsque la sécurité est activée, un port SSL (Secure Socket Layer) est aussi nécessaire. Pour indiquer le port SSL, utilisez l'option de ligne de commande suivante :
      -jvmArgs -Dcom.ibm.CSI.SSLPort=<sslPort>
    4. Facultatif : Spécifiez le port de service 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 pour les serveurs de catalogue

      Le port de service JMX peut être également défini à l'aide de la propriété de serveur JMXServicePort.

    5. Facultatif : Définissez le port de connecteur JMX.

      Le port de connecteur JMX est utilisé pour la communication entre les clients JMX. Pour indiquer le port de connecteur JMX, utilisez l'option de ligne de commande suivante :

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

      Le port de connecteur JMX peut être également défini à l'aide de la propriété de serveur JMXConnectorPort.

  3. Démarrez les noeuds finals client.
    Les clients ont uniquement besoin de connaître les noeuds finals d'écoute de service de catalogue. Les clients extraient les points de contact des machines virtuelles Java du serveur de conteneur, qui sont les machines virtuelles Java qui conservent les données, automatiquement du service de catalogue. Pour vous connecter au service de catalogue dans l'exemple précédente, le client doit envoyer la liste suivante de paires host:port à l'API connexion :
    hostA:2809,hostB:2809

    Le client peut également recevoir des rappels des serveurs de conteneur lors de l'utilisation de l'API DataGrid. Ces rappels communiquent en utilisant IIOP avec le port d'écoute ORB. Pour indiquer le port et l'adaptateur réseau pour recevoir des rappels, définissez les propriétés listenerHost et listenerPort dans le fichier de propriétés du client.

    Lorsque la sécurité est activée, un port SSL (Secure Socket Layer) est aussi nécessaire. Pour indiquer le port SSL, utilisez la propriété système suivante lors du démarrage du processus client :
    -jvmArgs -Dcom.ibm.CSI.SSLPort=<sslPort>