Este documento tem o intuito de informar como é feito o processo de configuração e instalação da nova versão do WildFly.
| Índice |
|---|
Downloads Necessários para Este Processo
Antes de realizar a instalação do Wildfly, é necessário que você tenha realizado o download de alguns arquivos, pois sem eles não teremos uma instalação bem sucedida, ok?
1. Download do Wildfly
Primeiramente, realize o download do arquivo do wildfly, versão 25.0.1.Final, através do link abaixo
| Dica | ||
|---|---|---|
| ||
https://github.com/wildfly/wildfly/releases/download/25.0.1.Final/wildfly-25.0.1.Final.zip |
2. Download do JAVA
Será necessário também que você realize o download de arquivos da Oracle. Mas, para tal, você precisa ter uma credencial no site da Oracle. Então a primeira coisa a fazer é criar uma credencial (caso você não possua) e em seguida logar no site da Oracle.
Agora que você já possui a credencial da Oracle, realize o download do JAVA. Ele é responsável pela execução do WildFly.
| Passos | Exemplos |
|---|---|
|
|
2. Será exibida uma tela onde você poderá criar sua credencial (Create Account), ou, caso você já possua uma, realizar o login no site (Sign in). Siga as orientações do site da Oracle para logar no site e poder realizar os downloads. |
|
Nossa recomendação é a versão 11 do JDK (Java SE Development Kit), conforme link abaixo, mas esta versão exige uma licença comercial. Se você desejar adquirir uma licença, clique aqui!
| Dica | ||
|---|---|---|
| ||
https://www.oracle.com/br/java/technologies/javase/jdk11-archive-downloads.html |
Caso não seja possível uso da licença comercial, indicamos o uso da JRE 8 (jre-8u202-windows-x64.tar.gz) que é a ultima versão antes das alterações no sistema de licenciamento licenciamento da Oracle. O download desta versão de JRE pode ser feito através do link abaixo.
| Dica | ||
|---|---|---|
| ||
https://www.oracle.com/br/java/technologies/javase/javase8-archive-downloads.html Procure na página por jre-8u202-windows-x64.tar.gz |
3. Download do Driver Ojdbc
Será necessário também realizar o download do driver ojdbc6.jar. Esse driver é responsável por controlar o acesso das aplicações ao Banco de Dados. Para tal, clique no link abaixo:
| Dica | ||
|---|---|---|
| ||
https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc6/ojdbc6-11.2.0.4.jar |
Etapa 1 - Configuração para Execução do Wildfly
Essa etapa é responsável por auxiliar nas configurações para execução da aplicação Wildfly
| Aviso | ||
|---|---|---|
| ||
Para a conclusão dessa etapa é necessário que tenha efetuado o download do pacote wildfly-25.0.1.Final.zip e uma das versões sugeridas do JAVA. |
| Passos | Exemplos | |||||
|---|---|---|---|---|---|---|
1- Extraia o pacote do wildfly-25.0.1.Final.zip em uma pasta de fácil acesso, por exemplo:
|
| |||||
| 2- Crie uma pata pasta chamada jre dentro do diretório raiz do Wildfly |
| |||||
| 3- Extraia o conteúdo do pacote JAVA para pasta wildfly-25.0.1.Final\jre (diretório criado no passo anterior) |
| |||||
| 4- Acesse a pasta wildfly-25.0.1.Final\bin e procurar pelo arquivo standalone.conf.bat |
| |||||
| 5- Abra o arquivo standalone.conf.bat com o editor de código de sua preferencia preferência e busque a propriedade "JAVA_HOME" no inicio da linha onde essa propriedade esta localizada existirá um comando "rem" remova-o ate para que fique como mostra o exemplo ao lado |
| |||||
| 6- Altere o valor da localização do diretório para que seja referenciada a pasta que foi criada no passo 3 "..\jre" |
| |||||
7- Ainda no arquivo standalone.conf.bat busque a propriedade JBOSS_JAVA_SIZING.
|
| |||||
| 8- Acesse a pasta wildfly-25.0.1.Final\bin e procurar pelo arquivo jboss-cli.bat |
| |||||
9- Abra o arquivo jboss-cli.bat com o editor de código de sua preferenciapreferência, e adicione na linha 14 a seguinte propriedade
|
| |||||
| 10- Acesse a pasta wildfly-25.0.1.Final\bin e procurar pelo arquivo add-user.bat |
| |||||
11- Abra o arquivo add-user.bat com o editor de código de sua preferencia preferência e adicione na linha 10 a seguinte propriedade
|
|
| Passos | Exemplos |
|---|---|
| Para testar se a configuração da JVM está correta deve-se inicializar o Wildfly por meio da execução do arquivo wildfly-25.0.1.Final\bin\standalone.bat |
|
| Verificar no log do console aberto se o java utilizado está no diretório configurado anteriormente |
|
| Quando o processo de inicialização do Wildfly finalizar deve-se executar um |
| Ctrl + |
| C no console |
| para matar o processo |
|
Etapa 2 -Adicionando um Usuário ao Wildfly
Essa etapa é responsável por demostrar como efetuar a criação de um usuário para ter acesso ao console de administrador do wildfly
| Passos | Exemplos |
|---|---|
1- No diretório wildfly-25.0.1.Final\bin execute o arquivo add-user.bat para adicionar um usuário para acessar o painel de administração do Wildfly no navegador.
|
|
| 2- E então digite qual será o nome do novo usuário e tecle Enter |
|
| 3- Informe a senha do novo usuário e tecle Enter (um aviso será exibido caso a senha informada seja considerada fraca, então digite yes para forçar a criação da senha e continuar) |
|
4- Após repetir a senha do usuário, será solicitado o grupo do usuário, pode deixado em branco e teclar Enter, por padrão o usuário será acrescentado ao grupo ManagementRealm |
|
5- Digite yes e Enter para confirmar |
|
6- Digite yes e Enter novamente para confirmar, e qualquer tecla para continuar e finalizar o processo |
|
Etapa 3 - Configurando o standalone.xml
Essa etapa tem o intuito de orientar a liberação de acesso ao console de administrador de maquinas máquinas presentes na rede em que o wildfly esteja conectado e tambem também aumentar o timeout para o deploys que serão feitos.
| Passos | Exemplos |
|---|---|
| 1- Acesse a pasta wildfly-25.0.1.Final\standalone\configuration e procurar pelo arquivo standalone.xml |
|
| 2- Abra o arquivo standalone.xml com o editor de código de sua preferencia preferência busque a propriedade <deployment-scanner |
|
3- Ao encontrar essa propriedade adicione a seguinte informação (NA MESMA LINHA):
|
|
| 4- Ainda no arquivo standalone.xml e procurar por <interfaces> |
|
| 5- Alterar as interfaces para o valor <any-address/> para permitir o acesso dos projetos e interface do console de administração do Wildfly a partir de outros computadores da mesma rede |
|
Etapa 4 - Criando serviço no Windows
Nessa etapa demonstraremos como é feita a configuração para a execução do Wildfly como serviço no sistema operacional Windows
| Passos | Exemplos |
|---|---|
| 1- Para criar o serviço do Wildfly é necessário copiar a pasta service presente no diretório wildfly-25.0.1.Final\docs\contrib\scripts para o diretório wildfly-25.0.1.Final\bin |
|
2- Por padrão o nome do serviço |
|
| 3- Para iniciar a criação do serviço acessar a pasta wildfly-25.0.1.Final\bin\service via cmd e execute ‘service.bat install’ (caso precise desinstalar por algum motivo execute ‘service.bat uninstall’) |
|
| 4- Abrir o gerenciador de serviços do Windows e verificar que o serviço do Wildfly foi criado |
|
5- Para habilitar a inicialização automática do serviço junto com o Windows, deve-se clicar com o botão direito do mouse e depois em Propriedades. Uma janela será aberta, altere a inicialização para automático e clique Ok |
|
6- Para testar, clique com o botão direito do mouse no serviço e depois em Iniciar |
|
| 7- Abrir o aquivo wildfly-25.0.1.Final\standalone\log\server.log para acompanhar o processo de inicialização |
|
| 8- Para testar a finalização do serviço, clique com o botão direito do mouse no serviço e depois em Parar. |
|
9- A finalização do serviço |
|
Etapa 5 - Realizar o Deploy Do OJDBC
Nessa etapa demonstraremos como é feito o Deploy do OJDBC
| Passos | Exemplos |
|---|---|
| 1- Abrir o navegador e acessar link http://localhost:9990/console/index.html e logar com o usuário criado anteriormente (O Serviço do Wildfly tem que estar iniciado) |
|
2- Após acessar a GUI do Wildfly ,
|  |
| 4- Clicar em |
|
| 5-Selecionar o arquivo ojdbc6.jar e |
| depois clicar em Abrir |
|
| 6 - Clicar em Next |
|
| 7- Conferir se os nomes estão corretos, |
| depois clicar em Finish |
|
| 8- "Upload Successful" clicar em Close para finalizar o deploy |
|
| 9- Esse é o status que deve ser exposto no Deploy da Gui do Wildfly. Após esse passo acompanha no log |
|
| 10- O log linx-wildfly\standalone\log\server.log deve ser verificado para validar que o deploy do driver foi realizado |
|
Etapa 6 - Criar um datasource
Nesta etapa será criado um datasource Oracle para acesso ao banco de dados.
Caso seja necessário um datasource MariaDB, acesso o link: Configurando o Wildfly para acessar o MariaDB
| Passos | Exemplos |
|---|---|
| 1 - Acessar Configuration → Subsystems → Datasources & Drivers → Datasources → AddDatasource |
|
| 2 - Escolher o tipo de banco Oracle e clicar Next |
|
3 - Colocar os campos Name: LinxDS e o JNDI Name: java:jboss/datasources/LinxDS e clicar Next |
|
4 - Selecionar o Driver ojdbc6.jar e clicar Next |
|
5 - Preencher os dados do banco com a URL no seguinte modelo: 5.1 - jdbc:oracle:thin:@ip:porta/nomeBanco (Quando a conexão do banco é via Service Name). Exemplo: jdbc:oracle:thin:@10.4.229.16:1521/ora11 5.2 - jdbc:oracle:thin:@ip:porta:nomeBanco (Quando a conexão do banco é via SID). Exemplo: jdbc:oracle:thin:@10.4.229.16:1521:ora11 |
|
6 - Fazer o teste de conexão e clicar Next |
|
7 - Na próxima tela clicar em Finish. Será exibida uma mensagem afirmando que o serviço precisar ser reiniciado. Quando o serviço terminar de reiniciar, então os deploys já podem ser realizados. |
