Migração do JBoss para Wildfly no Windows

Introdução

O JBoss 4 deixou de receber atualizações da Red Hat e por isso, além da questão de desempenho é necessário também que o JBoss seja substituído pelo Wildfly por uma questão de segurança.

Este guia é um compêndio dos passos necessários para fazer a atualização do servidor de aplicações, por isso, administradores do sistema que necessitem aprofundar em algum detalhe, pode recorrer ao manual de instalação do Sankhya Om.

Antes de começar precisamos também mencionar que a instalação do JBoss 4 consiste em um uma pasta que por padrão fica na pasta “c:/Sankhya/JBoss”. É possível que você encontre mais de uma instalação do JBoss na sua máquina servidora, eles estarão com nomes parecidos com “JBoss_prod”, “JBoss_teste”, “JBoss_homolog”.

📘

Importante

Conforme os passos a seguir, efetue primeiro a atualização do JBoss de teste ou de homologação.

1 - Finalize o JBoss enquanto aplicação

O primeiro passo para atualizar do JBoss para o Wildfly, é finalizar o processo que representa a execução do JBoss.

Por padrão o JBoss roda como serviço, sendo assim, basta acessar o painel de serviços do Windows e procurar por “Sankhya …“ ou “JBoss …” que será encontrado os serviços relacionados.

Após parar o serviço, será necessário excluí-lo, e isso pode ser feito pelos próprios recursos do Windows, como por exemplo, através do comando *SC delete nome_do_serviço (jboss_prod, jboss_treina, etc.)*.

E também pelo Gerenciador de Pacotes, na opção a partir do menu principal, selecionando a opção “[2] - Selecionar Servidor”, selecione o servidor, e após isso a opção “[10] - Desinstalar JBoss como serviço do Windows”.

2 - Mova a pasta do JBoss

O objetivo deste passo é guardar o JBoss caso o mesmo tenha algo importante ainda em sua instalação e não seja imediatamente perdido, além de retirar do local padrão de instalação para que não gere confusão. A dica é criar a pasta “c:/Sankhya/backup_jboss” e mover os arquivos para dentro desta pasta.

3 - Instale a JDK 8

O JDK pode ser obtido na Central de Downloads,. Clique aqui para ser redirecionado a página.

Para Windows, basta seguir o assistente de instalação nas opções padrões, clicando em “Next” e no último passo em “Finish”.

🚧

Atenção

Provavelmente a variável de ambiente JAVA_HOME definida no sistema operacional ainda estará com o Java 6, é necessário alterá-la para a nova instalação do JDK 8.

No Windows, basta pesquisar no menu Configurações.

4 - Faça o download do Wildfly

O Wildfly pode ser baixado pelo através da Central de Downloads. Após efetuar o download, descompacte-o na pasta padrão de instalação do Sankhya Om: “c:/Sankhya”.

5 - Registre o Wildfly no Gerenciador de Pacotes

Utilize a opção 4 do menu inicial do Gerenciador de Pacotes. Defina um nome, por exemplo, “wildfly_prod” e informe o caminho onde o mesmo se encontra. Esse nome do Wildfly é utilizado para criar o diretório de extensões e o serviço de inicialização.

6 - Configure o conjunto de portas do Wildfly

Tanto o JBoss como o Wildfly utilizam de algumas portas, por exemplo, 8080 para acesso HTTP. Quando há mais de um Wildfly instalado é importante configurar conjuntos de portas distintos para que o Wildfly de homologação possa rodar ao mesmo tempo que o Wildfly de produção.

7 - Configure a conexão com o banco de dados.

Novamente, através do Gerenciador de pacotes, no menu principal, escolha “[2] - Selecionar Servidor” e em seguida a opção “[1] Configurar Banco de Dados” e “[1] Editar configuração”.

Após selecionar esta opção, serão solicitados os dados de conexão com o banco, tais como a escolha do SGBD (Oracle ou SQL Server), o IP, porta, usuário e senha.

Preencha-os corretamente e certifique-se que o teste de conexão ao final foi bem sucedido. Caso o teste de conexão falhar, verifique os dados e tente novamente.

8 - Mova as extensões do JBoss para o Wildfly

Caso utilize extensões do Sankhya Om, é necessário mover as extensões que estavam dentro da pasta do JBoss para o Wildfly substituto. A pasta de extensão leva o nome de registro do servidor de aplicações (Wildfly ou JBoss).

9 - Mova a instalação do Sankhya Om do JBoss para o Wildfly

Basta mover o arquivo “sankhyaw_${VERSAO}.ear“ que está na pasta “${JBOSS}/server/default/deploy”, para a pasta “${WILDFLY}/standalone/deployments”. Os termos entre ${...}, indicam variações. Veja, por exemplo, alguns dos valores possíveis que você irá encontrar na sua instalação:

• ${VERSAO} = “4.10b100”, “4.12b7”, etc.
• ${JBOSS} = “c:/sankhya/jboss_prod”, “c:/sankhya/jboss_treina”, etc.
• ${WILDFLY} = “c:/sankhya/wildfly_prod”, “c:/sankhya/wildfly_treina”, etc.

10 - Inicialize o Wildfly

É extremamente recomendável a instalação do Wildfly como serviço, principalmente para o Wildfly de produção. A configuração da inicialização do Wildfly como serviço pode ser feita pelo Gerenciador de Pacotes através da opção “[2] Selecionar Servidor”, seguida da opção “[9] Instalar JBoss como serviço do Windows”

Há também a opção de inicialização do Wildfly através de script, exatamente como era com o JBoss, no Wildfly o arquivo é o standalone.bat que fica dentro da pasta “bin”.

Dúvidas

Caso tenha ainda alguma dúvida sobre o processo de migração do JBoss para Wildfly, consulte no botão abaixo a nossa FAQ com as perguntas frequentes, e confira se já existe uma resposta para sua pergunta.