É 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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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
- 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.
- 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.
- 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.
- 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>
- 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.
- 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.
- 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>