Este documento tem o intuito de informar como é feito o processo de configuração e instalação da nova versão do WildFly.
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
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!
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 da Oracle. O download desta versão de JRE pode ser feito através do link abaixo.
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:
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
ATENÇÂO
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 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 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.
INFO Essa alteração é necessária para que haja um ganho de performance da aplicação | |
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 preferencia, e adicione na linha 14 a seguinte propriedade
INFO acrescentar a configuração da JVM, por meio do apontamento para pasta jre criada em passos anteriores (usando a notação de diretório relativo anterior com ..) | |
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 e adicione na linha 10 a seguinte propriedade
|
Pasos | 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 Ctrol + c no console par 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 presentes na rede em que o wildfly esteja conectado e tambem 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 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/ 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 |