Tempo aproximado para leitura: 00:05:00 min
Dúvida
Como realizar a instalação do WildFly na versão 20.0.1.Final?
Ambiente
Cross Segmentos - TOTVS CRM Automação de Força de Vendas (SFA) - Infraestrutura - Versão 20.0.1
Solução
1. Acesse o download do WildFly 20.0.1.Final no seguinte link: wildfly-20.0.1.Final.zip
2. Descompacte o zip no caminho ws\serverapp\ e então renomeie o diretório criado como wildfly.
3. Validar se as variáveis de ambiente estão geradas (JAVA_HOME e JBOSS_HOME).
3.1.1 Caso tenha apenas um WildFly operando, podemos validar pelo próprio S.O, da seguinte forma:
3.1.2 Abra o menu iniciar do Windows e pesquise por variáveis de ambiente:
3.1.3 Clique em variáveis de ambiente:
3.1.4 Verifique se as variáveis do sistema estão definidas, sendo elas JAVA_HOME e JBOSS_HOME:
3.1.5 Caso elas não estejam presentes, clique na opção Novo e defina o nomeJBOSS_HOME, após selecione o diretório onde o WildFly está (geralmente \ws\serverapp\wildfly), então defina o nome JAVA_HOME e selecione o diretório onde o Java está (geralmente \ws\java\jre11), então dê om OK.
3.1.6 Validação finalizada.
3.2.1 Caso tenha mais de um WildFly operando, é necessário definir as variáveis de ambiente pelo arquivo standalone.conf.bat, encontrado no caminho ws\serverapp\wildfly\bin.
3.2.2 Após abrir o arquivo, adicione duas linhas de código no início definindo as variáveis de ambiente e seus respectivos locais:
Exemplo:
Exemplo de código a ser inserido:
set "JAVA_HOME=C:\ws\java\jre11"
set "JBOSS_HOME=C:\ws\serverapp\wildfly"
3.2.3 Validação finalizada.
4. Abra o arquivo standalone.xml, localizado no caminho: ws\serverapp\wildfly\standalone\configuration\.
4.1 Edite a seguinte linha especificando o uso do protocolo de segurança TLS 1.3:
(Antes)
(Depois)
Código a ser inserido:
enabled-protocols="TSLv1.3"
4.2 Adicione os seguintes filtros de segurança:
(Antes)
(Depois)
Código a ser inserido:
<filter-ref name="X-Frame-Options"/>
<filter-ref name="x-xss-protection"/>
<filter-ref name="strict-transport-security"/>
<filter-ref name="content-security-policy"/>
<filter-ref name="x-Content-type-options"/>
4.3 Adicionar as seguintes linhas, designando os filtros de cabeçalhos de segurança HTTP:
(Antes)
(Depois)
Código a ser inserido:
<filters>
<response-header name="X-Frame-Options" header-name="X-Frame-Options" header-value="SAMEORIGIN"/>
<response-header name="x-xss-protection" header-name="X-XSS-Protection" header-value="1; mode=block"/>
<response-header name="strict-transport-security" header-name="Strict-Transport-Security" header-value="max-age=31536000; includeSubDomains"/>
<response-header name="content-security-policy" header-name="content-security-policy" header-value="default-src 'self'; font-src 'self' data: use.typekit.net https://fonts.gstatic.com; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' gmaps-utility-library.googlecode.com https://*.googleapis.com https://*.gstatic.com *.google.com https://static.zdassets.com blob:; img-src * data:; connect-src *; frame-src *;"/>
<response-header name="x-Content-type-options" header-name="X-Content-Type-Options" header-value="nosniff"/>
</filters>
4.4 Edite o endereço IP, tornando o acesso disponível a todas as interfaces de rede:
(Antes)
(Depois)
127.0.01 --> 0.0.0.0
5. Abra o arquivo standalone.conf.bat, localizado no caminho ws\serverapp\wildfly\bin:
5.1 Adicione o seguinte bloco:
(Antes)
(Depois)
Código a ser inserido:
set "JAVA_OPTS=%JAVA_OPTS% -Djava.awt.headless=true -Dfile.encoding=UTF-8 -Djavax.servlet.request.encoding=UTF-8"
set "JAVA_OPTS=%JAVA_OPTS% -Djava.util.Arrays.useLegacyMergeSort=true"
set "JAVA_OPTS=%JAVA_OPTS% -Djboss.as.management.blocking.timeout=600"
5.2 A linha a seguir define parâmetros de configuração da JVM que podem ser ajustados conforme a necessidade da aplicação:
- -Xms = Define o tamanho inicial da heap (memória) da JVM. Este é o valor de memória com o qual a JVM começará sua execução.
- -Xmx = Define o tamanho máximo da heap que a JVM pode alocar. Limita o quanto a JVM pode expandir sua área de memória.
- -XX:+UseG1GC = Ativa o Garbage Collector G1 (G1GC), que gerencia a memória de forma eficiente, minimizando pausas durante a execução.
Importante!
Caso seja necessário fazer ajustes nesses parâmetros, o formato a ser seguido deve respeitar o modelo abaixo:
(Antes)
(Depois)
Código a ser inserido:
set "JAVA_OPTS=-Xms512M -Xmx2048M -XX:+UseG1GC"
6. Para realizar a criação de um usuário administrador, siga o seguinte processo:
6.1 Execute o script add-user.bat, que pode ser encontrado no caminho ws\serverapp\wildfly\bin.
6.2 Por padrão o Management User é selecionado, apenas aperte enter para prosseguir:
What type of user do you wish to add?
a) Management User (mgmt-users.properties)
b) Application User (application-users.properties)
(a):
6.3 O próximo passo será definir o nome do usuário, por padrão se utiliza o admin:
Enter the details of the new user to add.
Using realm 'ManagementRealm' as discovered from the existing property files.
Username : admin
6.4 Caso escolhido o usuário admin, você será informado que o usuário já existe e encontra-se inativo, por padrão a opção selecionada é a de atualizar a senha e o papel, importante ressaltar que essa opção também realiza a ativação do usuário:
User 'admin' already exists and is disabled, would you like to...
a) Update the existing user password and roles
b) Disable the existing user
c) Type a new username
(a):
6.5 Agora defina a senha desejada seguindo as regras exibidas:
Password recommendations are listed below. To modify these restrictions edit the add-user.properties configuration file.
- The password should be different from the username
- The password should not be one of the following restricted values {root, admin, administrator}
- The password should contain at least 8 characters, 1 alphabetic character(s), 1 digit(s), 1 non-alphanumeric symbol(s)
Password :
Re-enter Password :
6.6 Nesse momento será solicitada a definição do grupo, no exemplo abaixo não iremos designar nenhum deixando em branco e teclando enter:
What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[ ]:
Updated user 'admin' to file '/opt/wildfly-10.1.0.Final/standalone/configuration/mgmt-users.properties'
Updated user 'admin' to file '/opt/wildfly-10.1.0.Final/domain/configuration/mgmt-users.properties'
Updated user 'admin' with groups to file '/opt/wildfly-10.1.0.Final/standalone/configuration/mgmt-groups.properties'
Updated user 'admin' with groups to file '/opt/wildfly-10.1.0.Final/domain/configuration/mgmt-groups.properties'
6.7 Nessa parte o script irá perguntar se o usuário será utilizado para a autenticação entre 2 servidores WildFly, no exemplo abaixo digitaremos no e teclar enter:
Is this new user going to be used for one AS process to connect to another AS process?
e.g. for a slave host controller connecting to the master or for a Remoting connection for server to server EJB calls.
yes/no? no
7. Agora para iniciarmos o WildFly como serviço no Windows, siga os seguintes passos:
7.1 Abra o diretório ws\serverapp\wildfly\docs\contrib\scripts e copie a pasta service.
7.2 Agora entre no diretório ws\serverapp\wildfly\bin e cole a pasta service.
7.3 Clique na tecla Windows e pesquise por cmd, clique com botão direito e selecione Executar como Administrador.
7.4 Selecione o diretório onde está a pasta service com o seguinte comando:
Importante!
É importante lembrar que o disco de instalação pode variar, sendo necessário ajustar conforme necessidade.
cd C:\ws\serverapp\wildfly\bin\service
7.5 Escreva o seguinte comando para instalar o WildFly como um serviço:
service.bat install
7.6 Digita o seguinte comando para iniciar o WildFly como serviço:
net start WildFly
7.7 Clique nas teclas Windows+R e digite no pop-up aberto services.msc:
7.8 Procure pelo serviço Wildfly, clique nele com o botão direito e selecione a opção Propriedades:
7.9 No menu aberto, clique em tipo de inicialização, selecione a opção Automático (Atraso na inicialização) e depois clique em aplicar e OK.
0 Comentários