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.

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.



PassosExemplos

1- Extraia o pacote do wildfly-25.0.1.Final.zip em uma pasta de fácil acesso, por exemplo:

  • C:\ (mais indicado)
  • C:\Program Files


2- Crie uma pata chamada jre dentro do diretório raiz do WildFly

3- Extrair 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.

  • Ao encontrar a propriedade setJBOSS_JAVA_SIZING altere os seguintes valores:
    • De -Xms64M para -Xms512M

    • De-Xmx512Mpara -Xmx2048M

    • De -XX:MetaspaceSize=96M para -XX:MetaspaceSize=512M

    • De -XX:MaxMetaspaceSize=256m para -XX:MaxMetaspaceSize=1024m

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

  • set "JAVA_HOME=..\jre"

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
  • set "JAVA_HOME=..\jre"





PassosExemplos
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 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



PassosExemplos

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. 

  • Quando o console abrir, serão exibidas duas opções, então digite ‘a’ e tecle Enter para escolher a opção ‘Management User (mgmt-users.properties)

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 também aumentar o timeout para as instalações que serão feitas. 



PassosExemplos
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):

  • deployment-timeout="1200" para aumentar o deployment-timeout para 20 minutos

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 



PassosExemplos
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
criado é WildFly, o nome pode ser personalizado por meio de uma
edição no arquivo wildfly-25.0.1.Final\bin\service
\service.bat
, deve-se procurar
por SHORTNAME, DISPLAYNAME e editá-los conforme necessário

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 arquivo 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
também pode ser acompanhada
pelo log wildfly-25.0.1.Final
\standalone\log\server.log (adicionalmente também
pode-se verificar se o processo
do java foi finalizado no
Gerenciador de Tarefas)

Etapa 5 - Realizar o Deploy Do OJDBC

 Nessa etapa demonstraremos como é feita a instalação (deploy) do OJDBC 



PassosExemplos

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)

Atenção ao digitar a URL do Wildfly Mantendo oque esta destacado não pode mudar



2- Após acessar a GUI do WildFly ,

  1. Clicar em Deployments
  2. Clicar no "+"
  3. Clicar no Upload Deployment




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

  • Sem rótulos