Configurando Portas no Modo Independente

É possível configurar as portas necessárias para servidores e clientes em uma implementação do eXtreme Scale usando parâmetros da linha de comandos, arquivos de propriedades ou programaticamente. A maioria dos exemplos incluídos nas seções a seguir descreve parâmetros da linha de comandos para o script startOgServer. As opções de configuração equivalentes também podem ser configuradas nos arquivos de propriedades usando a API do servidor integrado ou a API do cliente.

Procedimento

  1. Inicie os terminais de serviço de catálogo.

    O WebSphere eXtreme Scale usa o IIOP para comunicação entre Java virtual machines. As JVMs do serviço de catálogo são os únicos processos que requerem uma configuração explícita das portas para os serviços IIOP e para as portas de serviços de grupo. Outros processos alocam portas dinamicamente.

    1. Especifique as portas de cliente e de peer. A porta do cliente e a porta equivalente são usadas para a comunicação entre serviços de catálogo em um domínio do serviço de catálogo. Para especificar a porta do cliente e porta equivalente, use a seguinte opção da linha de comandos:
      -catalogServiceEndPoints <serverName:hostName:clientPort:peerPort>
      No contêiner, referencia o host e a porta do Object Request Broker (ORB) no serviço de catálogo. Cada atributo é definido conforme a seguir:
      serverName
      Especifica o nome para identificar o processo que você está ativando.
      hostName
      Especifica o nome do host para o computador onde o servidor é ativado.
      clientPort
      Especifica a porta que é usada para comunicação de serviço de catálogo peer.
      peerPort
      Este valor é o mesmo que haManagerPort. Especifica a porta que é usada para comunicação de serviço de catálogo peer.
      O exemplo a seguir inicia o servidor de catálogos cs1, que está no mesmo domínio de serviço de catálogo que os servidores cs2 e cs3:
      startOgServer.bat|sh cs1 -catalogServiceEndPoints 
      cs1:MyServer1.company.com:6601:6602,
      cs2:MyServer2.company.com:6601:6602,
      cs3:MyServer3.company.com:6601:6602
      É possível também configurar os terminais de serviço de catálogo com a propriedade de servidor catalogServiceEndPoints.
    2. Configure a porta do listener do Object Request Broker (ORB). A porta do listener do Object Request Broker (ORB) é usada para comunicação entre os serviços de catálogo, em um domínio de serviço de catálogo, e para comunicação entre serviços de catálogos e servidores de contêiner e clientes. Para especificar a porta do listener e o host do listener, use as seguintes opções da linha de comandos:
      -listenerHost <nome do host>

      Especifica o nome do host ao qual o Object Request Broker (ORB) se conecta para comunicação com o Internet Inter-ORB Protocol (IIOP). O valor deve ser um nome de domínio ou endereço IP completo. Se sua configuração envolver diversas placas de rede, configure o host e a porta do listener para permitir que o Object Request Broker na JVM conheça o endereço IP para o qual se ligar. Se você não especificar qual endereço IP usar, sintomas tais como tempos limites de conexão, falhas de API incomuns e clientes que parecem ser interrompidos podem ocorrer.

      Padrão: localhost
      -listenerPort <porta>
      Especifica o número da porta ao qual o Object Request Broker (ORB) se conecta. Esta configuração define que contêineres e clientes se comunicam com o serviço de catálogo por meio do ORB. No WebSphere Application Server, a listenerPort é herdada pela configuração de porta BOOTSTRAP_ADDRESS. Esta propriedade se aplica ao servidor de contêiner e ao serviço de catálogo.Padrão: 2809

      É possível também configurar a porta do listener e o host do listener com as propriedades de servidor listenerHost e listenerPort.

    3. Opcional: Configure a porta de serviço JMX.

      A porta de serviço JMX é usada para comunicação a partir de clientes JMX. Para especificar a porta de serviço JMX, use a seguinte opção da linha de comandos:

      -JMXServicePort <porta>
      Especifica o número da porta na qual o servidor MBean recebe a comunicação com Java Management Extensions (JMX). A propriedade JMXServicePort especifica a porta não SSL para o JMX. Você deve usar um número da porta diferente para cada JVM na configuração. Se desejar usar JMX/RMI, especifique explicitamente JMXServicePort e o número da porta, mesmo se desejar usar o valor de porta padrão. Essa propriedade se aplica ao servidor de contêiner e ao serviço de catálogo. (Necessário somente para ambientes independentes.)

      Padrão: 1099 para servidores de catálogos

      É possível também configurar a porta de serviço JMX com a propriedade de servidor JMXServicePort.

    4. Opcional: Configure a porta do conector JMX.

      A porta do conector JMX é usada para a comunicação dos clientes JMX. Para especificar a porta do conector JMX, use a opção de linha de comandos a seguir:

      -JMXConnectorPort <port>
      Define a porta Secure Sockets Layer (SSL) à qual o serviço Java Management Extensions (JMX) se conecta.

      É possível também configurar a porta do conector JMX com a propriedade de servidor JMXConnectorPort.

    5. Configure a porta Secure Socket Layer (SSL).
      Quando a segurança é ativada, uma porta SSL também é necessária. Para especificar a porta SSL, use a seguinte opção da linha de comandos:
      -jvmArgs -Dcom.ibm.CSI.SSLPort=<sslPort>
    Figura 1. Exemplo do Uso da Linha de Comandos. Inicie o primeiro servidor de catálogos no hostA. A seguir há um exemplo do comando:
    ./startOgServer.sh cs1 -listenerHost hostA -listenerPort 2809 
    -catalogServiceEndPoints cs1:hostA:6601:6611,cs2:hostB:6601:6611
    Inicie o segundo servidor de catálogos no hostB. A seguir há um exemplo do comando:
    ./startOgServer.sh cs2 -listenerHost hostB 
    -listenerPort 2809 -catalogServiceEndPoints cs1:hostA:6601:6611,cs2:hostB:6601:6611
  2. Inicie os terminais do servidor de contêiner.

    O seguinte comando inicia uma JVM de contêiner para uso com o serviço de catálogo de exemplo:

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

    O servidor de contêiner Java Virtual Machines usa duas portas. A porta do gerenciador de HA é usada para comunicação interna entre os servidores de contêiner e servidores de catálogos equivalentes. A porta do listener é usada para comunicação IIOP entre servidores de contêiner, servidores de catálogos e clientes peer. O host do listener é usado para ligar o ORB a um adaptador de rede específico. Se não for especificada, ambas as portas serão selecionadas dinamicamente. No entanto, se desejar configurar portas explicitamente, tal como em um ambiente de firewall, será possível usar uma opção da linha de comandos para especificar a porta do ORB.

    1. Especifique o host e a porta do listener. Para especificar a porta do listener e o host do listener, use as seguintes opções da linha de comandos:
      -listenerHost <nome do host>

      Especifica o nome do host ao qual o Object Request Broker (ORB) se conecta para comunicação com o Internet Inter-ORB Protocol (IIOP). O valor deve ser um nome de domínio ou endereço IP completo. Se sua configuração envolver diversas placas de rede, configure o host e a porta do listener para permitir que o Object Request Broker na JVM conheça o endereço IP para o qual se ligar. Se você não especificar qual endereço IP usar, sintomas tais como tempos limites de conexão, falhas de API incomuns e clientes que parecem ser interrompidos podem ocorrer.

      Padrão: localhost
      -listenerPort <porta>
      Especifica o número da porta ao qual o Object Request Broker (ORB) se conecta. Esta configuração define que contêineres e clientes se comunicam com o serviço de catálogo por meio do ORB. No WebSphere Application Server, a listenerPort é herdada pela configuração de porta BOOTSTRAP_ADDRESS. Esta propriedade se aplica ao servidor de contêiner e ao serviço de catálogo.Padrão: 2809

      É possível também configurar a porta do listener e o host do listener com as propriedades de servidor listenerHost e listenerPort.

    2. Especifique a porta do gerenciador HA. Para especificar a porta do gerenciador JMX, use a seguinte opção da linha de comandos:
      -haManagerPort <porta>
      Especifica o número da porta que o gerenciador de alta disponibilidade usa. Se essa propriedade não for configurada, uma porta livre não será escolhida. Essa propriedade é ignorada nos ambientes WebSphere Application Server.

      É possível também configurar a porta do gerenciador HA com a propriedade de servidor HAManagerPort.

    3. Opcional: Especifique a porta SSL.
      Quando a segurança está ativada, uma porta Secure Socket Layer (SSL) também é necessária. Para especificar a porta SSL, use a seguinte opção da linha de comandos:
      -jvmArgs -Dcom.ibm.CSI.SSLPort=<sslPort>
    4. Opcional: Especifique a porta de serviço JMX.
      -JMXServicePort <porta>
      Especifica o número da porta na qual o servidor MBean recebe a comunicação com Java Management Extensions (JMX). A propriedade JMXServicePort especifica a porta não SSL para o JMX. Você deve usar um número da porta diferente para cada JVM na configuração. Se desejar usar JMX/RMI, especifique explicitamente JMXServicePort e o número da porta, mesmo se desejar usar o valor de porta padrão. Essa propriedade se aplica ao servidor de contêiner e ao serviço de catálogo. (Necessário somente para ambientes independentes.)

      Padrão: 1099 para servidores de catálogos

      É possível também configurar a porta de serviço JMX com a propriedade de servidor JMXServicePort.

    5. Opcional: Configure a porta do conector JMX.

      A porta do conector JMX é usada para a comunicação dos clientes JMX. Para especificar a porta do conector JMX, use a opção de linha de comandos a seguir:

      -JMXConnectorPort <port>
      Define a porta Secure Sockets Layer (SSL) à qual o serviço Java Management Extensions (JMX) se conecta.

      É possível também configurar a porta do conector JMX com a propriedade de servidor JMXConnectorPort.

  3. Inicie os terminais do cliente.
    Os clientes devem conhecer somente os terminais do listener do serviço de catálogo. Os clientes recuperam terminais para o servidor de contêiner Java Virtual Machines, que são os Java Virtual Machines que mantém os dados, automaticamente a partir do serviço de catálogo. Para conectar-se ao serviço de catálogo no exemplo anterior, o cliente deve transmitir a lista a seguir de pares host:port para a API de conexão:
    hostA:2809,hostB:2809

    O cliente também pode receber os retornos de chamadas a partir dos servidores de contêiner ao usar a API do DataGrid. Esses retornos de chamada se comunicam usando o IIOP com a porta do listener do ORB. Para especificar a porta e o adaptador de rede para receber retornos de chamada, configure as propriedades listenerHost e listenerPort no arquivo de propriedades do cliente.

    Quando a segurança está ativada, uma porta Secure Socket Layer (SSL) também é necessária. Para especificar a porta SSL, use a seguinte propriedade de sistema ao iniciar o processo do cliente:
    -jvmArgs -Dcom.ibm.CSI.SSLPort=<sslPort>