Manual de Instalação Wildfly

Introdução

Esse manual possui as instruções para a instalação do servidor Wildfly versão 26.0.1.Final no sistema operacional Windows.

Para a execução dos comandos exemplificados neste manual foi utilizado o aplicativo powershell, caso o usuário opte pela utilização do prompt de comando a sintaxe deverá ser revista.

Downloads

Wildfly

JDK (Java Development Kit)

Aplicação (.ear)

Versão

Beta

Instalação

Extrair o arquivo wildfly-26.0.1.Final-Fiorilli.7z em um diretório, recomenda-se por padrão adicioná-lo ao diretório Fiorilli na raiz de uma unidade de disco, ex: "C:\Fiorilli".

Extrair o arquivo do jdk dentro do diretório wildfly-26.0.1.Final.

Configuração

Abrir o diretório wildfly-26.0.1.Final\bin.

Executar o arquivo standalone.bat para iniciar o servidor, ele deverá ficar aberto para a execução dos comandos a seguir.

Criar Datasource

Executar o arquivo jboss-cli.bat.

Digitar o comando connect e pressionar a tecla "ENTER" para conectar no servidor:

connect

Caso seja definida uma nova porta para o console do wildfly ou um deslocamento de porta geral(offset) será necessário informá-la no comando connect:

connect localhost:9991

Copiar o comando abaixo para um editor de texto, substituir as diretivas {IP}, {PORTA} e {CAMINHO} pelas informações de conexão com o banco de dados, colar o comando atualizado no prompt do jboss-cli.bat e pressionar a tecla "ENTER":

/subsystem=datasources/data-source=SipWebFirebird:add(jndi-name=java:/SipWebFirebird,
                                    connection-url="jdbc:firebirdsql:{IP}/{PORTA}:{CAMINHO}?lc_ctype=WIN1252;authPlugins=Legacy_Auth",
                                    driver-name=jaybird_5.0.4, user-name=FSCSIP,
                                    credential-reference={store=fiorilli-store, alias=sip-ds}, use-ccm=true, jta=true,
                                    transaction-isolation=TRANSACTION_READ_COMMITTED, min-pool-size=5, max-pool-size=15,
                                    pool-prefill=true, flush-strategy=FailingConnectionOnly,
                                    check-valid-connection-sql="select codigo from empresa")

Certificado digital (Protocolo HTTPS) - opcional

Gerar o arquivo JKS (Java KeyStore)

Utilizar o prompt de comando ou o powershell como administrador para navegar até o diretório wildfly-26.0.1.Final\jdk\bin:

cd C:\Fiorilli\wildfly-26.0.1.Final\jdk\bin

$Navegar para o diretório jdk\bin$

Executar o comando informando o caminho do certificado para exibir as informações:

.\keytool -v -list -storetype pkcs12 -keystore
                                        C:\Teste\certificadodigital.pfx

Utilizar o alias do certificado para criar o JKS através dos comandos:

.\keytool -importkeystore -srckeystore
                                        C:\Teste\certificadodigital.pfx
                                        -srcstoretype pkcs12 -alias "1" -destkeystore C:\Teste\keystore.jks
                                        -deststoretype JKS

.\keytool -changealias -alias "1" -destalias
                                        "keystore" -keystore
                                        C:\Teste\keystore.jks

Vincular o arquivo JKS ao HTTPS

Copiar o arquivo keystore.jks gerado anteriormente para o diretório wildfly-26.0.1.Final\standalone\configuration\tls.

Executar os comandos informando a senha (***) utilizada para a geração do JKS através do jboss-cli.bat:

/subsystem=elytron/key-store=fiorilliKeyStore:write-attribute(name=credential-reference.clear-text,
                                        value=***)

/subsystem=elytron/key-manager=fiorilliKeyManager:write-attribute(name=credential-reference.clear-text,
                                        value=***)

Serviço

Fechar o arquivo standalone.bat para parar o servidor.

Utilizar o prompt de comando ou o powershell como administrador para navegar até o diretório wildfly-26.0.1.Final\bin\service.

Registrar o serviço

Executar o comando ".\service.bat install" para instalar o serviço:

.\service.bat install

Caso já exista uma instalação local do serviço será necessário informar o novo host/porta para o console do wildfly (/controller), o nome do serviço (/name) e o nome de exibição (/display) através do comando install:

.\service.bat install /controller "localhost:9991" /name "Wildfly2" /display "Wildfly 2"