Ambiente Desenvolvimento e Produção

Ambiente e Versões Homologados

Registro das versões e sistema utilizados durante o processo de certificação do ambiente:

• Java
  • jdk-20.0.2 x64bits - Para servidor de aplicações
  • jdk-8u301 - Para alguns módulos e aplicações quando necessário. Deve ser documentado no módulo o uso da versão 32 ou 64 bits.
• IDEs
  • Eclipse: eclipse-jee-2023-06-R-win32-x86_64.zip
• Servidor de Aplicações
  • wildfly-29.0.0.Final
• Versionamento
  • Deixamos de utilizar o SVN próprio e utilizar os repositórios privados do GitHub.
  • O Eclipse já vem com o EGit (plugin da própria eclipse instalado e com suporte)

Instalação do WildFly

1. Faça o 'download' da versão homologada pelo BIS em https://www.wildfly.org/downloads/
2. Descompacte o conteúdo em 'C:\'

Definindo o caminho do Java

Para garantir que o WildFly utilizará o Java homologado, e não o java padrão disponível no sistema, é preciso forçar o caminho do JAVA_HOME em suas configurações.

• No Windows
  • Edite o arquivo 'WILDFLY_HOME\bin\standalone.conf.bat'
  • Procure a linha 'rem set "JAVA_HOME=C:\opt\jdk1.6.0_23"', remova o 'rem' e a corrija para que aponte para o JDK homologado

• No Linux
  • Edite o arquivo 'WILDFLY_HOME\bin\standalone.conf'
  • Procure a linha '#JAVA_HOME="/opt/java/jdk"', remova o '#' e a corrija para que aponte para o JDK homologado

Adicionando Usuário Administrador

1. Execute o comando WILDFLY_HOME\bin\add-user'
2. Escolha a opção 'Management User'
3. Crie o usuário 'bis'
4. Senha 'biserp2003'
5. Deixe em branco os grupos adicionais do usuário (apenas pressione ENTER)
6. Confirme com 'Yes' as próximas perguntas

Erro de JAVA no add-user Se tiver problemas relacionado a versão do Java provavelmente é por estar utilizando uma versão do Java não compatível com o WildFly. Para executar o script, ou troque sua versão padrão do java para executar esse script, ou edite o arquivo add-user.bat e inclua a linha: set "JAVA_HOME=c:\Program Files\Java\jdk-20" antes do código que testa o Java Home: if "x%JAVA_HOME%" == "x" (

Incluindo o Driver JDBC do MySQL

1. Baixe o JDBC homologado pelo BIS
   1. Para a versão 8.0.11: baixe com

      wget https://downloads.mysql.com/archives/get/p/3/file/mysql-connector-java-8.0.11.tar.gz

   2. Descompacte com

      sudo tar -xvf mysql-connector-java-8.0.11.tar.gz

2. Cria a pasta 'WILDFLY_HOME\modules\system\layers\base\com\mysql\main'
3. Copie o JAR do JDBC para esta pasta
4. Crie um arquivo 'module.xml' dentro da pasta com o seguinte conteúdo:

<?xml version="1.0" encoding="UTF-8"?>
<module name="com.mysql" xmlns="urn:jboss:module:1.9">
    <resources>
        <resource-root path="mysql-connector-java-8.0.11.jar" />
    </resources>
    <dependencies>
        <module name="javax.api"/>
        <module name="javax.transaction.api"/>
    </dependencies>
</module>

Iniciando o Servidor

Para iniciar o servidor execute o comando 'WILDFLY_HOME\bin\standalone'.

Standalone Vs. Domain Diferentemente da definição do Glassfish, o modo Domínio é utilizado para rodar múltiplas instâncias do WildFly distribuído em Cluster, Servidores, Etc. O BIS por enquanto não tem necessidade de rodar em um ambiente dividido em múltiplos servidores e domínios, por isso é executando no modo standalone tanto no ambiente de Homologação quanto de Produção.

Configuração do Datasource

Configuração do Driver JDBC

1. Com o servidor já em execução, acesse o 'Painel de Administração'.
2. Acesse 'Configuratoin -> Subsystem -> Datasources & Drivers -> JDBC Drivers'.
3. Clique no botão de '+' para adicionar uma nova configuração do Driver do MySQL

   

4. Complete os campos com as seguintes informações:
   1. Driver Name - MySQL
   2. Driver Module Name - com.mysql
   3. Driver Class Name - com.mysql.cj.jdbc.Driver
   4. Driver XA Datasource Class - com.mysql.cj.jdbc.MysqlXADataSource

   

Configuração do DataSource

1. Acesse 'Configuratoin -> Subsystem -> Datasources & Drivers -> Datasources'.
2. Clique no Botão '+' e escolha a opção 'Add Datasoruce para adicionar um novo DataSource. (Não seleciona a opção XA!)
3. Escolha a opção 'Custom'. Apesar de existir uma opção do MySQL, ela não permite as configurações necessárias.
4. Em Atributes preencha com:
   1. Name - BISDS
   2. JNDI Name - java:/jdbc/BISDS
5. Em JDBC Driver apenas escolha o driver que configuramos anteriormente MySQL
6. Em Connection complete com:
   1. Connectino URL - jdbc:mysql://localhost:3306?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=America%2FSao_Paulo
   2. User Name - Usuário do MySQL
   3. Password - Senha do MySQL
   4. Security Domain - deixar em branco
7. Teste a conexão e finalize a criação do DS

Falha no Teste da Conexão Algumas vezes, por algum erro, a conexão com o banco de dados falha. Mesmo voltando, arrumando e tentando realizar um novo teste a conexão com o banco falha. Parece que o WildFly tem algum BUG neste sentido. Pois já tive casos de o teste da conexão falhar, e concluí a configuração - apertando finish - e depois que a conexão foi inserida e o servidor 'reloaded', o teste de conexão resultar em sucesso.

Configurações Adicionais Servidor Produção

TimeZone

Embora a partir da versão 10 o BIS utilize o LocalDate, o sistema ainda apresenta alguns "pontos falhos" em que se utilizar do TimeZone do sistema. Por isso é necessário que o servidor esteja configurado para o TimeZone 'America/Sao_Paulo'.

Configurando o TimeSync Service no Amazon Linux

1. Exclua o NTP atual:

   sudo yum erase 'ntp*'

2. Instale o Chrony:

   sudo yum install chrony

3. Configure o NTP da Amazon (Talvez o mais recomendado seja instalar o NTP brasileiro, mas confiando que o da amazon terá os horários de verão configurados corretamente, mantive). Edite o arquivo /etc/chrony.conf. Se a linha não existir crie-a depois das instruções server ou pool. Caso exista, recomendo que passe para baixo de todas.

   sudo nano /etc/chrony.conf

   server 169.254.169.123 prefer iburst minpoll 4 maxpoll 4

4. Reinicie o serviço:

   sudo service chronyd restart

   Para visualizar se o server está sendo utilizado corretamente, utilize o comando:

   chronyc sources -v

   Ou as métricas de sincronização com:

   chronyc tracking

Configurando o TimeZone Para ver os TimeZones disponíveis navegue dentro da pasta /usr/share/zoneinfo. Neste tutorial já vamos configurar para America/Sao_Paulo.

1. Abra o arquivo /etc/sysconfig/clock

   sudo nano /etc/sysconfig/clock

2. Altere seu conteúdo conforme abaixo:

   ZONE="America/Sao_Paulo"

   UTC=true

3. Crie um symLink para o arquivo de TimeZone correspondente, conforme exemplo abaixo:

   sudo ln -sf /usr/share/zoneinfo/America/Sao_Paulo /etc/localtime

4. Reinicie a instância

   sudo reboot

5. Verifique a data com

   date

Eclipse

Instalação

1. Baixe o eclipse diretamente do site Eclipse Fundation.
2. Instale descompactando o .zip em seu local de preferência.

Definição da VM para Execução do Eclipse

Se precisar definir a VM para execução (inicialização) do Eclipse. Edite o arquivo eclipse.ini na raiz do eclipse, e inclua/modifique os parâmetros como o exemplo abaixo:

-vm
c:/Program Files/Java/jdk-19/bin/javaw.exe

Quebra de Linha Observe que a quebra de linha é obrigatória, cada parâmetro em uma linha separada. A definição da JVM de execução normalmente só é necessária caso o Eclipse apresente erros durante sua inicialização.

JAutoDoc

Este plugin permite que todo o javaDoc criado para um "field" (atributo da classe) seja replicado automaticamente nos métodos Get e Set ao pressionar a tecla de atalho 'CTRL+ALT+J'.

Instalação pelo MarketPlace

1. Vá em 'Help -> Eclipse Marketplace' e procure por 'JAutoDoc'.
2. Clique em Instalar siga os passos e Reinicie quando solicitado

Configuração do Módulo

1. Após a instalação vá no menu 'Windows > Preferences', no caminho 'Java > JAutoDoc' e clique no botão 'Import All...' para importar as configurações usadas no projeto BIS.
2. O arquivo com as opções salvas ficam no projeto 'BIS' no arquivo 'etc\Environment Setup\jautodoc-eclipse.xml'.

Configurando o JDK e Bibliotecas no Eclipse

Ao carregar o pom.xml do Maven, o Eclipse configurará o projeto para utilizar o Execution Environment de acordo com a versão do JDK definida no arquivo. Por isso, é importante que o Execution Environment do Eclipse esteja apontando para o JDK homologado. Atualmente o Execution Environment é o JavaSE-1.8.

Versão x64 e x32 Embora o BIS esteja homologado para rodar na versão 64bits, alguns módulos e aplicações externas podem requerer a versão 32bits. Um exemplo é o BISPDV que por questões de compatibilidade com DLLs de SAT, Impressoras, PinPads e etc., precisam rodar em 32Bits. Para estes casos a cada vez que o Eclipse recarregar o pom.xml do Maven, é necessário configurar manualmente que desejamos que o projeto rode no JDK de 32bits homologado.

1. Vá em 'Windows -> Preferences -> Java -> Installed JREs'
2. Adicione a instalação do JDK homologado apontando para a pasta do JDK de 64 bits homologado.
3. Repita o passo anterior para a versão do JDK de 32 bits homologado.
4. Vá em 'Windows -> Preferences -> Java -> Installed JREs -> Execution Environment e em JavaSE-1.8 escolha o JDK 64bits homologado.

Maven Desde a adoção do Maven para controlar as bibliotecas de cada projeto não é mais necessário realizar configurações extras de bibliotecas no Eclipse

Configurando o WildFly

Antes de configurar o Servidor é necessário baixar o plugin do servidor.

1. Vá na aba 'Servidor e click para criar um novo servidor.
2. Na tela que se abre, escolha 'JBoss AS, WildFly, & EAP Server Tools' e clique em Next. Este passo pode demorar.

   

3. Termine os passos do Wizard até finalizar. Aguarde o fim da instalação e reinicie se for solicitado.
4. Após o término e reinicio do Eclipse, volte à aba 'Servers' e clique em adicionar um novo servidor novamente.
5. Desta vez escolha a opção 'WildFly27+', e deixe o Server Name como 'WildFly'.

   

6. Clique em 'Next.
7. Na próxima imagem escolha a opção 'Management Operation' para que o Eclipse controle o WildFly corretamente.

   * Para que o eclipse controle adequadamente o a instalação do WildFly precisa ser realizada como orientado nesta página.}}

   

8. Na definição de RunTime, selecione o ambiente conforme homologado.

   

9. Clique em Finish