Faculdade de Engenharia
Licenciatura em Engenharia Informática
Tutorial de Instalação e
Configuração WildFly
Elaborado por:
Ivandro Colombo (iColombo)
Luanda – 2020
Tutorial de Instalação e
Configuração WildFly
Elaborado por:
Ivandro Colombo (iColombo)
Luanda – 2020
Sobre o Autor
I
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
Epígrafe
Tomás da Silva
II
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
Breves Considerações
Este tutorial visa à explicação do Servidor de aplicativo Java WildFly sua instalação
e configuração nos Sistemas Operativos Ubuntu, CentOS e Windows.
III
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
ÍNDICE
Sobre o Autor............................................................................................................................... I
Epígrafe ....................................................................................................................................... II
Breves Considerações.............................................................................................................. III
1. Introdução .......................................................................................................................... 1
2. Requisitos ........................................................................................................................... 2
3. Configuração das Distros ..................................................................................................... 3
3.1 Instalação e configuração do WildFly ............................................................... 3
3.2 Criação de um usuário (utilizador) ................................................................... 7
3.2.1 Criação de um usuário (utilizador) executando os scripts
WildFly ............................................................................................................... 7
3.2.2 Criação de um usuário (utilizador) usando o assistente do
Apache NetBeans 12.0 LTS ............................................................................. 7
3.3 Conexões ................................................................................................................. 9
3.4 Implantação de um Projecto ............................................................................. 17
4. Confirguração do ambiente Windows............................................................................. 22
4.1 Instalação e configuração do WildFly ............................................................. 22
4.2 Instalando o WildFly como serviço.................................................................. 24
4.3 Criação de um usuário (utilizador) ................................................................. 25
4.3.1 Criação de um usuário (utilizador) executando os scripts
WildFly ............................................................................................................. 25
4.3.2 Criação de um usuário (utilizador) usando o assistente do
Apache NetBeans 12.0 LTS ........................................................................... 26
4.4 Conexões ............................................................................................................... 27
4.5 Implantação de um Projecto ............................................................................. 35
5. Resolução de bugs na inicialização do WildFly ............................................................. 39
6. Conclusão .............................................................................................................................. 42
7. Bibliografia ........................................................................................................................... 43
IV
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
1. Introdução
1
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
2. Requisitos
- Sistemas Operativos
- CentOS 7;
- Windows 10;
- OpenJDK 8;
- WildFly 20.0.1.Final.
Obs.: Frisar que à maneira de configurar o ambiente Ubuntu 18.04 LTS não difere
das outras distribuições e a forma de configurar o CentOS 7 é semelhante às outras
versões (6 e a 8), dizer que versões abaixo destas deixaram de ser mantidas e a 6 só
será mantida até 30 de Novembro de 2020, e à maneira de configurar o ambiente
Windows 10 é semelhante a todas às outras versões.
2
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
3. Configuração das Distros
Antes de instalar ou configurar o WildFly, temos que nos certificar que o OpenJDK 8
esteja instalado, caso não estiver acesse o link abaixo do tutorial no qual explico
como o fazer para CentOS e Windows.
https://www.academia.edu/43783614/Tutorial_preparacao_ambiente_desenvolvi
mento_java_opensource
E o blog a seguir que explica como fazer a instalação no Ubuntu.
https://www.edivaldobrito.com.br/java-no-ubuntu-instalar-o-openjdk-8/
Abaixo eis os passos para instalar e configurar o WildFly como serviço, caso
queiramos fazê-lo pela sua forma mais básica, apenas o copiamos para o directório
/opt ou outro qualquer desde que devidamente permitido: /opt/wildfly-20.0.1.Final
e executamos o ficheiro standalone.sh contido em /opt/wildfly-20.0.1.Final/bin
tanto na distro CentOS quanto Ubuntu.
1. Criamos um novo usuário (utilizador) do sistema com o directório
/opt/wildfly
$ sudo groupadd -r wildfly
$ sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly
2. Instalamos o WildFly
Até o preciso momento que escrevo este tutorial, a última versão é o WilFly 21, mas
para este tutorial usarei a versão 20, por já o ter usado e responder com o que se lhe
pede, mas a forma de instalação e configuração é a mesma.
Antes de fazeres o download ou continuar a instalação e configuração com o WildFly
20.0.1 Final já baixado contido num dispositivo amovível ou num directório crie uma
variável de ambiente e atribua valor como se segue:
$ WILDFLY_VERSION=20.0.1.Final
Caso não tenha feito o download siga as seguintes instruções para o fazer:
2.1 – Fazemos o download do WildFly para o directório /tmp
wget https://download.jboss.org/wildfly/$WILDFLY_VERSION/wildfly-
$WILDFLY_VERSION.tar.gz -P /tmp
2.2 – Descompactamos o conteúdo comprimido ou zipado para o directório
/opt
3
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
$ sudo tar xf /tmp/wildfly-$WILDFLY_VERSION.tar.gz -C /opt/
Caso tenha os conteúdos previamente baixados num directório do Sistema ou
contido num dispositivo amovível:
2.3 – Copiamos os conteúdos previamente baixados para o directório /opt
$ sudo tar xf /tmp/wildfly-$WILDFLY_VERSION.tar.gz -C /opt/
No meu caso eu o tenho num dispositivo amovível, como podem notar executei o
comando:
$ sudo scp -r wildfly-20.0.1.Final/ /opt/
Nota: Caso tenha os conteúdos baixados contidos num dispositivo amovível e não
queira dar-se trabalho de navegar entre os directórios no terminal abra o directório
ou pasta em questão e com o botão direito do mouse (rato), escolha a opção “open
in Terminal” em inglês e “abrir no Terminal” em português.
3. Criamos um link simbólico wildfly que apontará para o directório de
instalação do WildFly
$ sudo ln -s /opt/wildfly-$WILDFLY_VERSION /opt/wildfly
4
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
$ sudo mkdir -p /etc/wildfly
Este ficheiro permite que tu especifiques qual o modo e endereços bind do WildFly.
Por padrão, WildFly executará no modo standalone e será escutado em todas
interfaces. Tu podes editar o ficheiro de acordo às suas necessidades.
Caso queiramos visualizar o conteúdo do ficheiro apenas, façamos:
$ cat /etc/wildfly/wildfly.conf
# The configuration you want to run
WILDFLY_CONFIG=standalone.xml
$ sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service
/etc/systemd/system/
Para adicionar um novo usuário ou utilizador use o script add-user.sh que está
localizado no directório bin do WildFly:
$ sudo /opt/wildfly/bin/add-user.sh
8
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
Após o Servidor de aplicativo (middleware) ser adicionado o nosso usuário
(utilizador) já estará criado. Após todas estas configurações o nosso servidor de
aplicativo está pronto a ser usado. Digitamos no browser de internet o link
http://localhost:8080 e aparecerá a página inicial.
3.3 Conexões
Para criarmos as nossas conexões, tão logo estivermos na página inicial como
referido anteriormente, clicamos na opção Administration Console que nos levará
directamente para a página de administração do WildFly, o mesmo também é
possível digitando na barra de endereço do browser de internet o link
http://localhost:9990.
Antes de criarmos qualquer conexão, primeiro teremos de adicionar o driver do
PostgreSQL ao WildFly, como o nosso middleware usa o conceito de módulos,
teremos de configurar o driver como módulo, neste caso no directório ou pasta
adequada que é: /opt/wildfly-20.0.1.Final/modules/system/layers/base/org/.
Nele criaremos os directórios /postgresql/main
No qual em … main, conterá o driver e um ficheiro module.xml. Abaixo eis o
conteúdo de module.xml:
<?xml version='1.0' encoding='UTF-8'?>
<module xmlns="urn:jboss:module:1.1" name="org.postgresql">
<resources>
<resource-root path="postgresql-42.2.12.jar"/>
</resources>
<dependencies>
9
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
<module name="javax.api"/>
<module name="javax.transaction.api"/>
</dependencies>
</module>
10
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
11
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
12
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
13
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
14
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
15
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
Nota: Caso a conexão não seja reconhecida no Apache NetBeans 12.0 LTS, copiamos
ela do ficheiro standalone.xml e o colamos em standalone-full.xml, isso acontece
quando iniciamos uma instância do middleware diferente da do nosso IDE. Dizer
que se criarmos uma conexão com uma instância diferente da do middleware
16
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
padrão também teremos de copiar de modos a aparecer na instância iniciada do
middleware separada do IDE. Nesse caso copiaremos do ficheiro standalone-full.xml
e o colamos em standalone.xml de modos que as conexões sejam vistas nas duas
instâncias.
Para implantarmos um projecto seja ele, JAR (Java Archive), WAR (Web Archive),
EAR (Enterprise Archive), seguimos os procedimentos abaixo.
17
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
Selecionamos a primeira opção “Upload Deployment”.
18
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
19
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
Obs.: Para fazer o undeploy ou tirar o app do WildFly, clicamos em view e
pressionamos a opção undeploy.
Para aceder basta digitar na barra de endereço do browser de internet:
http://localhost:8080/SIG_TESTE_ENTERPRISE-war
20
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
21
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
4. Confirguração do ambiente Windows
Antes de instalar ou configurar o WildFly, temos que nos certificar que o OpenJDK 8
esteja instalado, caso não estiver acesse o link abaixo do tutorial no qual explico
como o fazer para CentOS e Windows.
https://www.academia.edu/43783614/Tutorial_preparacao_ambiente_desenvolvi
mento_java_opensource
E o blog a seguir que explica como fazer a instalação no Ubuntu.
https://www.edivaldobrito.com.br/java-no-ubuntu-instalar-o-openjdk-8/
Obs.: Não instalarei ele como serviço apenas será feita a instalação básica.
Antes de qualquer execução adicionaremos o caminho (path) C:\wildfly-
20.0.1.Final do WildFly nas variáveis de ambiente.
22
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
Para iniciar ou executar o WildFly de modo mais básico, navegamos até o directório
C:\wildfly-20.0.1.Final\bin e executamos o script standalone.bat.
23
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
Obs.: Caso o script não esteja a executar convém verificar se algum aplicativo não
esteja a usar a porta 8080, executando os seguintes comandos no CMD como
Administrador:
>netstat -o -n -a
>netstat -aon | find /I “listening”
Para matar o processo usamos o commando abaixo.
>taskkill /f /PID numero_pid
Para adicionar um novo usuário ou utilizador use o script add-user.bat que está
localizado no directório bin do WildFly e seguimos as instruções:
25
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
4.3.2 Criação de um usuário (utilizador) usando o assistente do Apache
NetBeans 12.0 LTS
26
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
Após o Servidor de aplicativo (middleware) ser adicionado o nosso usuário
(utilizador) já estará criado. Após todas estas configurações o nosso servidor de
aplicativo está pronto a ser usado. Digitamos no browser de internet o link
http://localhost:8080 e aparecerá a página inicial.
4.4 Conexões
Para criarmos as nossas conexões, tão logo estivermos na página inicial como
referido anteriormente, clicamos na opção Administration Console que nos levará
directamente para a página de administração do WildFly, o mesmo também é
possível digitando na barra de endereço do browser de internet o link
http://localhost:9990.
Antes de criarmos qualquer conexão, primeiro teremos de adicionar o driver do
PostgreSQL ao WildFly, como o nosso middleware usa o conceito de módulos,
teremos de configurar o driver como módulo, neste caso no directório ou pasta
adequada que é: C:\wildfly-20.0.1.Final\modules\system\layers\base\org.
Nele criaremos os directórios \postgresql\main
No qual em … main, conterá o driver e um ficheiro module.xml. Abaixo eis o
conteúdo de module.xml:
<?xml version='1.0' encoding='UTF-8'?>
<module xmlns="urn:jboss:module:1.1" name="org.postgresql">
<resources>
<resource-root path="postgresql-42.2.12.jar"/>
</resources>
<dependencies>
27
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
<module name="javax.api"/>
<module name="javax.transaction.api"/>
</dependencies>
</module>
28
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
29
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
30
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
31
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
32
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
33
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
Nota: Caso a conexão não seja reconhecida no Apache NetBeans 12.0 LTS, copiamos
ela do ficheiro standalone.xml e o colamos em standalone-full.xml, isso acontece
quando iniciamos uma instância do middleware diferente da do nosso IDE. Dizer
que se criarmos uma conexão com uma instância diferente da do middleware
padrão também teremos de copiar de modos a aparecer na instância iniciada do
middleware separada do IDE. Nesse caso copiaremos do ficheiro standalone-full.xml
e o colamos em standalone.xml de modos que as conexões sejam vistas nas duas
instâncias.
34
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
4.5 Implantação de um Projecto
Para implantarmos um projecto seja ele, JAR (Java Archive), WAR (Web Archive),
EAR (Enterprise Archive), seguimos os procedimentos abaixo.
35
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
36
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
Obs.: Para fazer o undeploy ou tirar o app do WildFly, clicamos em view e
pressionamos a opção undeploy.
Para aceder basta digitar na barra de endereço do browser de internet:
http://localhost:8080/SIG_TESTE_ENTERPRISE-war
37
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
38
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
5. Resolução de bugs na inicialização do WildFly
40
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
41
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
6. Conclusão
42
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com
7. Bibliografia
https://google.com
https://wildfly.org
https://netbeans.apache.org
https://developers.redhat.com
https://linuxize.com/post/how-to-install-wildfly-on-centos-7
https://vitux.com/install-and-configure-wildfly-jboss-on-ubuntu
https://linuxize.com/post/how-to-install-wildfly-on-ubuntu-18-04
http://www.mastertheboss.com/jboss-server/jboss-configuration/installing-wildfly-on-windows
43
Copyright © Universidade Católica de Angola. 2020 Todos Direitos Reservados.
ivandrocolombo86@gmail.com