Configuração de Multidomínios no WildFly

Nos casos em que já se utiliza o conceito de multidomínio no GlassFish e há a necessidade de migrar para o WildFly, é preciso seguir os passos abaixo:

1. Pré-requisitos da Migração
   • Para realizar a migração de multidomínios do GlassFish para o WildFly, é essencial seguir os pré-requisitos descritos na documentação WildFly - Processo de instalação e configuração, garantindo que a configuração dos domínios no SeniorInstaller utilize o mesmo Profile, Server Group, e Socket Binding Group. Isso é fundamental para o balanceamento de carga entre os domínios.
2. Processo de Migração:
   • Execute o SeniorUpdater.exe para a versão 6.10.4.

   Observação

   Caso haja uma migração a ser realizada, aparecerá a tela de "Ajuste de Configurações / Domínios", onde serão identificados os domínios aptos para migração.

3. Configuração dos Domínios:
   • Clique em Avançar para acessar a tela de configuração de cada domínio.
   • Defina o mesmo Profile, Server Group, e Socket Binding Group para todos os domínios que fazem parte do balanceamento de carga.
4. Conclusão:
   • Siga até o final do processo para completar a migração para o WildFly com sucesso.
     

Após finalizar esses passos, o WildFly estará pronto para realizar o balanceamento de carga entre os domínios. A próxima etapa é instalar e configurar o ActiveMQ-Artemis, que será responsável pelo balanceamento dos processos assíncronos.

Procedimento para Criação de Domínios Manualmente Servidores (Máquinas) Diferentes:

Caso o balanceamento de carga seja realizado em servidores distintos, siga os passos abaixo para configurar os domínios:

1. Acesse a console administrativa do WildFly (porta padrão 9990).
2. Insira as credenciais de administrador (usuário: admin / senha padrão: adminadmin).
3. Navegue até o menu Runtime > Server Groups.
4. Selecione o Server Group do Gestão do Ponto.
5. Clique no botão de adicionar (+) no menu Server para criar um novo servidor.
   
   • Insira um nome para o novo domínio.
   • Selecione o Host onde o servidor do Gestão do Ponto já está configurado.
   • Escolha a opção On/Off para que o servidor inicie automaticamente quando o WildFly for iniciado.
   • Defina o Socket Binding Default Interface (por padrão, Public).
   • Selecione o Socket Binding Group utilizado pelo Gestão do Ponto (por padrão, full-sockets).
     • Insira um valor no campo Socket Binding Port Offset para garantir que o WildFly adicione esse valor à porta padrão do Socket Binding, evitando que vários servidores utilizem a mesma porta.

       Exemplo:

       Se a porta padrão do Socket Binding for 8080 e o valor 40 for inserido, a porta desse servidor será configurada como 8120.

Procedimento para Criação de Domínios no Mesmo Servidor (Máquina Única)

Caso o balanceamento de carga seja realizado no mesmo servidor, o processo é simplificado:

• Em Server, clique no botão com a seta para baixo, no server que já possui o deploy do Gestão do Ponto, selecione a opção Copy, para criar um balanceamento com os domínios na mesma máquina.
  • Insira um nome para o novo domínio.
  • Escolha o Server Group a que o servidor pertence.
  • Insira um valor no campo Socket Binding Port Offset para garantir que o WildFly adicione esse valor à porta padrão do Socket Binding.

    Exemplo:

    Se a porta padrão for 8080 e o valor 40 for adicionado, a nova porta será 8120.

    

    

 

O ActiveMQ Artemis é utilizado como camada de mensageria JMS para realizar o balanceamento das filas de requisição em ambientes com multidomínios no WildFly. Diferentemente do GlassFish, que utiliza o OpenMQ como mensageria JMS, no WildFly a solução homologada é o ActiveMQ Artemis.

Versão Homologada

A versão do ActiveMQ Artemis homologada pela Senior para o Gestão do Ponto é a 2.34.0. Abaixo está o link para download:

Download ActiveMQ Artemis 2.34.0

Procedimento para Criação e Configuração do Broker ActiveMQ Artemis

Etapas para Criação do Broker:

1. Faça o download da versão 2.34 do ActiveMQ Artemis.
2. Descompacte o arquivo .zip em um diretório definitivo.
3. Abra o CMD como administrador.
4. Acesse a pasta bin do Artemis.

   

5. Execute o comando

   

6. Insira o usuário para acesso ao Artemis.
7. Defina a senha para o usuário criado.
8. Escolha se permitirá o acesso anônimo ao Artemis, inserindo uma das seguintes opções:
   • Y = Sim;
   • N = Não;
   • True = Verdadeiro;
   • False = Falso.

Após a criação do Broker, é necessário iniciá-lo para realizar as configurações. Isso pode ser feito manualmente via CMD ou instalando-o como um serviço, conforme os passos descritos abaixo:

• Manual:
  1. Abra o CMD como administrador.
  2. Navegue até o diretório <Apache-Artemis>\bin.
  3. Execute o comando

     

• Instalar como serviço:
  1. Abra o CMD como administrador.
  2. Acesse o diretório <apache-artemis>\<broker>\bin.
  3. Execute o comando

     

Com o Broker instalado e em execução, é necessário vincular o Socket Binding do Gestão do Ponto ao Broker. Para isso, configure o Socket Binding associando a porta do Broker, que por padrão é a 61616, seguindo os passos abaixo:

Configurando o Socket Binding do Gestão do Ponto no WildFly:

1. Acesse a console administrativa do WildFly (porta padrão 9990).
2. Insira as credenciais de administrador (usuário: admin / senha padrão: adminadmin).
3. Navegue até Configuration > Socket Binding.
4. No Socket Binding Group, selecione o Socket Binding do Gestão do Ponto e clique em View.

   

5. No menu Outbound Remote, clique em Add.
   • Insira o nome remote-artemis no campo Name.
   • Digite o nome do servidor do Artemis no campo Host.
   • Insira a porta do Artemis (padrão: 61616) no campo Port.
   • Clique em Add.

     

Também é necessário vincular o Profile do WildFly ao remote-artemis criado anteriormente. Para isso, siga os passos abaixo:

Vinculando o Profile do WildFly ao Remote-Artemis:

1. Acesse Configuration > Profiles.
2. Selecione o Profile do Gestão do Ponto.
3. Navegue até Subsystem > Messaging > Server > Default > Connections e clique em View.

   

4. No menu Connector, selecione Remote.

   

   1. Clique em Add e insira o nome remote-artemis nos campos Name e Socket Binding.

      Observação:

      Como remote-artemis não aparece automaticamente no Socket Binding, será necessário digitá-lo manualmente.

5. Clique em Save.
6. Ainda na tela Connections, acesse Pool Connection Factory.
7. Selecione ActiveMQ-ra e clique em Edit.

   

8. No campo Connectors, insira remote-artemis, selecione essa opção e remova qualquer outra chave configurada. A única opção que deve permanecer selecionada é remote-artemis.

   

   

9. Na tela de Connection, acesse o menu Connection Factory e adicione remote-artemis no campo Connectors para todas as conexões do Gestão do Ponto, conforme explicado anteriormente.
10. Alterar o campo Reconnect Attempts para -1 em todas as conexões.

    

11. Connections a serem alteradas:
    • NotificationConnectionFactory
    • ProcessoColetivoFactory
    • RONDAG6AcertoFactory
    • RONDAG6ConnectionFactory
    • SeniorTopicFactory

    Lembre-se de salvar após cada alteração em cada Connection.

Com isso, finalizamos a configuração do vínculo entre o Artemis e o WildFly.

Quando o WildFly for utilizado em um ambiente com balanceamento de carga entre servidores em diferentes máquinas, é necessário configurá-lo para trabalhar com a estrutura de Domain Controller e Host Controller. Nessa configuração, uma máquina física (ou virtual) atuará como o Domain Controller, gerenciando outras máquinas físicas ou virtuais que servirão exclusivamente como Host Controllers.

Estrutura de Configuração

• O Domain Controller será responsável pela configuração do Socket Binding e do Profile de todos os Server Groups.
• As máquinas configuradas como Host Controllers executarão a aplicação e atuarão como hospedeiras da JVM, gerenciando o balanceamento de carga.

Configuração do Host Controller

Para configurar uma máquina como Host Controller (responsável apenas por hospedar a JVM), siga os passos abaixo:

1. Instale o WildFly normalmente na máquina que será o Host Controller.
2. Acesse o arquivo Host.xml e faça as seguintes alterações:

   Defina um nome para o host (pode ser o nome do servidor):

   Copiar

   <HOST XMLNS="URN:JBOSS:DOMAIN:20.0" NAME="TESTE23"> <EXTENSIONS> <EXTENSION MODULE="ORG.JBOSS.AS.JMX"/> <EXTENSION MODULE="ORG.WILDFLY.EXTENSION.CORE-MANAGEMENT"/> <EXTENSION MODULE="ORG.WILDFLY.EXTENSION.ELYTRON"/> </EXTENSIONS>

3. No Subsystem Elytron, adicione as seguintes linhas para configurar a autenticação:

   Defina um nome para o host (pode ser o nome do servidor):

   Copiar

   <PROFILE> <SUBSYSTEM XMLNS="URN:JBOSS:DOMAIN:CORE-MANAGEMENT:1.0"/> <SUBSYSTEM XMLNS="URN:WILDFLY:ELYTRON:18.0" FINAL-PROVIDERS="COMBINED-PROVIDERS" DISALLOWED-PROVIDERS="ORACLEUCRYPTO"> <AUTHENTICATION-CLIENT> <AUTHENTICATION-CONFIGURATION SASL-MECHANISM-SELECTOR="DIGEST-MD5" NAME="HOSTAUTHCONFIG" AUTHENTICATION-NAME="ADMIN" REALM="MANAGEMENTREALM"> <CREDENTIAL-REFERENCE CLEAR-TEXT="ADMINADMIN"/> </AUTHENTICATION-CONFIGURATION> <AUTHENTICATION-CONTEXT NAME="HCAUTHCONTEXT"> <MATCH-RULE AUTHENTICATION-CONFIGURATION="HOSTAUTHCONFIG"/> </AUTHENTICATION-CONTEXT> </AUTHENTICATION-CLIENT> <PROVIDERS> <AGGREGATE-PROVIDERS NAME="COMBINED-PROVIDERS"> <PROVIDERS NAME="ELYTRON"/> <PROVIDERS NAME="OPENSSL"/> <PROVIDERS>

4. Na diretiva Domain Controller, substitua <local> por:
   Copiar

   <DOMAIN-CONTROLLER> <REMOTE PROTOCOL="HTTP-REMOTING" HOST="<NOME/IP DO SERVIDOR DOMAIN CONTROLLER>" PORT="<PORTA ADM DO WILDFLY>" AUTHENTICATION-CONTEXT="HCAUTHCONTEXT" USERNAME="<USUÁRIO ADMIN DO WILDLFY>"/> </DOMAIN-CONTROLLER>

   • Substitua <nome/IP do servidor Domain Controller> pelo nome ou IP do servidor Domain Controller.
   • Substitua <porta adm do WildFly> pela porta administrativa do WildFly (padrão: 9990).
   • Substitua <usuário admin do WildFly> pelo nome do usuário administrador do WildFly (padrão: admin).

Após realizar essas configurações, inicie o WildFly nos Host Controllers. Verifique na página administrativa do Domain Controller os Host Controllers já devem aparecer corretamente.

Para mais detalhes, consulte a documentação oficial do WildFly sobre Domain Controllers no seguinte link:

WildFly - Domain Controller Configuration