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 - Nesse mesmo arquivo entre as propriedades <extensions>...</extensions> e <management>, adicionar a seguinte informação conforme a imagem ao lado: <system-properties> | |
5 - Ainda no arquivo standalone.xml e procurar por <interfaces> | |
56 - 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. |