Migração do GlassFish para WildFly - Atualização (10.3 > 10.4)

As seguintes configurações serão exigidas durante a migração:

• Diretório anterior do GlassFish;
• Servidor de administração e porta de administração do WildFly, utilizados para autenticação via API REST;
• Credenciais do usuário administrador do WildFly;

As portas e demais parâmetros necessários para criação das novas configurações serão obtidos automaticamente a partir das informações retornadas pelo WildFly, mantendo compatibilidade com as definições anteriormente utilizadas no GlassFish.

Exemplo da configuração que deve ser feita no Instalador:

Migrações de customização: guia prático de criação de File Handler no WildFly

Para realizar migrações de customização, siga os passos e use os comandos a seguir:

1. Conexão ao Controller

Descrição: conecta o CLI ao Domain Controller.

Copiar

jboss-cli.bat --connect controller=HOST:9990

• Substitua HOST pelo nome ou IP do servidor.

2. Criação do File Handler

Copiar

/profile=PROFILE/subsystem=undertow/configuration=handler/file=HANDLER_NAME:add(path="PATH")

Parâmetros:

• PROFILE - nome do profile no domínio (exemplos: gep6104; full; etc.)
• HANDLER_NAME - nome identificador do handler (exemplo: handler-docs).
• PATH - diretório físico que será servido.

Exemplo usando variável do servidor:

Copiar

/profile=gep6104/subsystem=undertow/configuration=handler/file=handler-docs:add(path="${jboss.server.data.dir}/docs")

Exemplo com caminho absoluto (Windows):

Copiar

/profile=gep6104/subsystem=undertow/configuration=handler/file=handler-docs:add(path="c:\\files\\docs")

Observação

O diretório informado deve existir no sistema de arquivos antes de executar o comando.

Variáveis padrão disponíveis no WildFly

As variáveis abaixo podem ser usadas em PATH para tornar o diretório dinâmico conforme o ambiente:

Variável	Descrição	Exemplo de resolução
${jboss.home.dir}	Diretório raiz da instalação do WildFly	C:\wildfly-30.0.1.Final
${jboss.server.data.dir}	Diretório de dados do servidor	C:\wildfly-30.0.1.Final\domain\servers\gep6104\data
${jboss.domain.base.dir}	Diretório base do domínio	C:\wildfly-30.0.1.Final\domain
${jboss.domain.servers.dir}	Diretório que contém os subdiretórios dos servidores de domínio	C:\wildfly-30.0.1.Final\domain\servers
${jboss.server.log.dir}	Diretório de logs do servidor	C:\wildfly-30.0.1.Final\domain\servers\gep6104\log
${jboss.server.temp.dir}	Diretório temporário do servidor	C:\wildfly-30.0.1.Final\domain\servers\gep6104\tmp

Essas variáveis são resolvidas automaticamente no momento da execução do CLI e podem ser combinadas com subdiretórios personalizados.

3. Criação da Location (mapeamento da URL)

Copiar

/profile=PROFILE/subsystem=undertow/server=default-server/host=default-host/location="/URL_PATH":add(handler="HANDLER_NAME")

Parâmetros:

• PROFILE - mesmo profile usado no handler.
• URL_PATH - caminho da URL que será exposto. Deve iniciar com: /
• HANDLER_NAME - nome do handler criado anteriormente.

Exemplo:

Copiar

/profile=gep6104/subsystem=undertow/server=default-server/host=default-host/location="/docs":add(handler="handler-docs")

Descrição: as requisições para /docs serão direcionadas para o diretório configurado no handler.

4. Aplicar a configuração

Copiar

:reload-servers(blocking=true)

Descrição: recarrega todos os servidores do domínio aplicando as alterações. O parâmetro blocking=true faz o comando aguardar até o fim do reload.

Quando for necessário criar um servidor novo, devem-se considerar as seguintes definições:

• Após informar Servidor de administração, Porta, Usuário e Senha, o instalador realizará a conexão via API REST e carregará automaticamente as informações disponíveis no domínio, como Host Controller, Server Group, Profile e Socket Binding Group existentes.
• Caso seja informado um nome de Profile ou Socket Binding Group que não exista, o instalador permitirá a edição das portas e sugerirá a criação desses itens conforme o nome informado.
• Caso seja utilizada uma configuração já existente, as portas e parâmetros serão carregados automaticamente e exibidos conforme configurado no WildFly.

Caso o servidor do WildFly já tenha sido previamente configurado, ao informar Servidor de administração, Porta, Usuário e Senha, o instalador realizará a leitura das configurações diretamente pela API REST. As informações referentes a Profile, Server, Server Group e Socket Binding Group serão automaticamente carregadas e os campos correspondentes serão bloqueados quando já existirem no domínio.

As portas também serão carregadas automaticamente, evitando retrabalho e garantindo consistência com o que já está configurado no WildFly. Após concluir essa etapa, o instalador seguirá com os demais passos da migração sem necessidade de novas interações do usuário.