Como Instalar o Servidor de Aplicações Java GlassFish no Rocky Linux

GlassFish é uma implementação gratuita e de código aberto da Plataforma Java EE desenvolvida pela Eclipse. É a principal implementação da plataforma Java EE no mundo. Ele fornece um servidor de aplicações leve e permite que você implante várias aplicações baseadas em Java. O GlassFish suporta vários tipos de tecnologias de aplicações Java, como Enterprise JavaBeans, JPA, JavaServer Faces, JMS e muitas mais.

O GlassFish é uma das melhores escolhas para desenvolvedores desenvolverem e implantarem aplicações baseadas em Java. Ele permite que os desenvolvedores criem aplicações empresariais de maneira conveniente e também com uma arquitetura escalável. O projeto GlassFish foi originalmente iniciado pela Sun Microsystem. Ele vem com duas licenças gratuitas diferentes - A Licença Comum de Desenvolvimento e Distribuição e a Licença Pública Geral GNU.

Neste tutorial, instalaremos o Servidor de Aplicações Java GlassFish com o proxy reverso Nginx no Rocky Linux. Instalaremos o Java OpenJDK, instalaremos o GlassFish via o pacote binário e instalaremos e configuraremos o Nginx como um proxy reverso.

Pré-requisitos

Para começar, você deve garantir que possui os seguintes requisitos:

• Um servidor Rocky Linux - Você pode usar o Rocky Linux 8 ou 9.
• Um usuário não-root com privilégios de sudo root/administração.
• Um nome de domínio local para o servidor de desenvolvimento local.

Agora vamos para a instalação.

Instalando o Java OpenJDK

O GlassFish é um Servidor de Aplicações Java. Para instalá-lo, você deve instalar o Java OpenJDK em seu servidor.

No momento da redação deste texto, a versão mais recente do GlassFish 6.2.5 requer pelo menos o Java OpenJDK 11. E agora, você começará a instalação instalando o Java OpenJDK 11 no sistema Rocky Linux.

O Java OpenJDK padrão está disponível no repositório appstream do Rocky Linux. Instale-o via o seguinte comando dnf.

sudo dnf install java-11-openjdk

Quando solicitado, digite y para confirmar e pressione ENTER para prosseguir, e a instalação do Java OpenJDK começará.

Em seguida, execute o seguinte comando java para verificar sua instalação. Você deve receber a saída do Java OpenJDK 11 instalado no Rocky Linux.

java -version

Uma vez que o Java OpenJDK esteja instalado, o próximo passo será baixar o GlassFish e instalá-lo manualmente a partir do pacote binário.

Baixando o Aplicativo GlassFish

O GlassFish é uma implementação compatível com Java EE desenvolvida pela Eclipse. Você pode instalá-lo manualmente construindo a partir do código-fonte ou instalá-lo via o pacote de distribuição binária fornecido pela Eclipse.

Nesta etapa, você instalará o GlassFish via o pacote de distribuição binária que pode ser baixado do site da Eclipse.

Antes de iniciar a instalação do GlassFish, execute o seguinte comando dnf para instalar o pacote unzip. Isso será usado para extrair o pacote de distribuição do GlassFish.

sudo dnf install unzip

Em seguida, execute o seguinte comando para criar um novo usuário dedicado para o GlassFish. Neste exemplo, você executará o servidor de aplicações GLassFish via o usuário não-root ‘ glassfish ‘.

sudo useradd -m -d /opt/glassfish6 -U -s /bin/false glassfish

Após o usuário ‘ glassfish ‘ ser criado, navegue até o diretório ‘/tmp’ e baixe o pacote de distribuição binária do GlassFish via o comando wget abaixo.

cd /tmp  
wget https://download.eclipse.org/ee4j/glassfish/glassfish-6.2.5.zip

E você deve obter o novo arquivo ‘glassfish-6.2.5.zip ‘.

Execute o seguinte comando unzip para extrair o pacote GlassFish ‘ glassfish-6.2.5.zip ‘ para o diretório ‘/opt’.

unzip /tmp/glassfish-6.2.5.zip -d /opt

Agora que o pacote GlassFish foi extraído para o diretório ‘/opt/glassfish6’.

Por fim, execute o seguinte comando para alterar a propriedade do diretório de instalação do GlassFish ‘ /opt/glassfish6 ‘ para o usuário e grupo ‘ glassfish ‘.

sudo chown -R glassfish:glassfish /opt/glassfish6

Agora que você baixou o pacote GlassFish, você pode iniciar manualmente o aplicativo GlassFish via o arquivo binário ‘/opt/glassfish6/bin/asadmin’. Mas para facilitar, você configurará e executará o GlassFish como um serviço systemd.

Executando o GlassFish como Serviço Systemd

Neste guia, você executará o Servidor de Aplicações Java GlassFish via o serviço systemd. Isso permite que você gerencie o servidor de aplicações GlassFish facilmente via o comando systemctl.

Para começar, crie um novo arquivo de serviço systemd ‘/lib/systemd/system/glassfish.service ‘ usando o seguinte editor nano.

sudo nano /lib/systemd/system/glassfish.service

Adicione a seguinte configuração ao arquivo.

[Unit]  
Description = GlassFish Server v6  
After = syslog.target network.target  
  
[Service]  
User=glassfish  
ExecStart=/opt/glassfish6/bin/asadmin start-domain  
ExecReload=/opt/glassfish6/bin/asadmin restart-domain  
ExecStop=/opt/glassfish6/bin/asadmin stop-domain  
Type = forking  
  
[Install]  
WantedBy = multi-user.target

Salve o arquivo e saia do editor quando terminar.

Em seguida, execute o seguinte comando systemctl para recarregar o gerenciador systemd e aplicar o novo arquivo de serviço ‘ glassfish.service ‘.

sudo systemctl daemon-reload

Agora que você recarregou o gerenciador systemd, você pode iniciar e habilitar o serviço ‘ glassfish ‘ via o seguinte comando systemctl.

sudo systemctl start glassfish  
sudo systemctl enable glassfish

Uma vez que o serviço ‘ glassfish ‘ esteja iniciado, execute o seguinte comando systemctl para verificar o serviço ‘ glassfish ‘ e garantir que o serviço esteja em execução.

sudo systemctl status glassfish

Você deve receber a saída do serviço ‘ glassfish ‘ em execução como a seguinte captura de tela.

Agora que o aplicativo Java GlassFish está em execução, o próximo passo será começar a configurar a administração do GlassFish.

Configurando a Administração do GlassFish

A instalação padrão do GlassFish vem sem uma senha de administrador. Portanto, agora você configurará o usuário e a senha de administração para o GlassFish e protegerá a instalação do GlassFish via a linha de comando ‘ /opt/glassfish6/bin/asadmin ‘.

Execute o seguinte comando para começar a configurar o usuário e a senha de administrador para sua instalação do GlassFish.

sudo -u glassfish /opt/glassfish6/bin/asadmin --port 4848 change-admin-password

Agora você será solicitado a fornecer alguns dados da administração do GlassFish.

• Digite o usuário para o GlassFish - o usuário padrão é ‘admin’.
• A instalação padrão do GlassFish vem sem uma senha, então pressione ENTER.
• Agora digite a nova senha para sua instalação do GlassFish e repita.

Você deve agora ter uma mensagem de saída como ‘ Comando change-admin-password executado com sucesso ‘.

Após configurar o usuário de administração do GlassFish, você começará a proteger sua instalação do GlassFish.

Execute o seguinte comando para começar a proteger o GlassFish.

sudo -u glassfish /opt/glassfish6/bin/asadmin --port 4848 enable-secure-admin

Quando solicitado pelo usuário e senha do administrador do GlassFish, insira os detalhes que você configurou anteriormente. Quando tudo estiver concluído, você verá a saída como ‘ Comando enable-secure-admin executado com sucesso ‘.

Em seguida, execute o seguinte comando para reiniciar o serviço ‘ glassfish ‘ e aplicar as novas alterações.

sudo systemctl restart glassfish

Neste ponto, o GlassFish agora está em execução com um novo usuário e senha de administração e também está protegido. O Servidor de Aplicações Java GlassFish padrão está em execução na porta ‘ 8080 ‘, e a administração do GlassFish está em execução na porta 4848.

Antes de acessar sua instalação do GlassFish, execute o seguinte comando firewall-cmd para abrir as portas 8080 e 4848.

sudo firewall-cmd --add-port=8080/tcp --zone=public  
sudo firewall-cmd --add-port=4848/tcp --zone=public

Por fim, abra seu navegador da web e visite o endereço IP seguido da porta 8080 (ou seja: http://192.168.5.100:8080). Você deve agora ver a página padrão index.html do seu Servidor de Aplicações Java GlassFish.

Para a administração do GlassFish, visite o endereço IP do servidor com a porta 4848 (ou seja: http://192.168.5.100:4848/). E você deve ver a página de login da administração do GlassFish.

Configurando o Nginx como Proxy Reverso

Neste ponto, o aplicativo Java GlassFish está em execução com a administração habilitada e protegida. Agora você instalará o Nginx e configurará como um proxy reverso para o GlassFish.

Usando o proxy reverso Nginx, você executará o GlassFish na porta padrão HTTP ou HTTPS (se habilitado).

Execute o seguinte comando dnf para instalar o servidor web Nginx. Quando solicitado pela configuração, digite Y e pressione ENTER para prosseguir.

sudo dnf install nginx

Em seguida, crie uma nova configuração de bloco de servidor Nginx ‘ /etc/nginx/conf.d/glassfish.conf ‘ usando o seguinte editor nano. Esta configuração fará com que o Nginx funcione como um proxy reverso para o GlassFish.

sudo nano /etc/nginx/conf.d/glassfish.conf

Adicione a seguinte configuração ao arquivo e certifique-se de alterar o nome de domínio local ‘ glassfish.howtoforge.local ‘ pelo seu domínio.

upstream glassfish6 {  
  server 127.0.0.1:8080 weight=100 max_fails=5 fail_timeout=5;  
}  
  
server {  
  listen          80;  
  server_name     glassfish.howtoforge.local;  
  
  location / {  
        proxy_set_header X-Forwarded-Host $host;  
        proxy_set_header X-Forwarded-Server $host;  
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
        proxy_pass http://glassfish6/;  
  }  
}

Salve o arquivo e feche o editor quando terminar.

Em seguida, execute o seguinte comando para verificar as configurações do Nginx. Se você tiver a configuração correta, deverá ver a mensagem de saída como ‘ Sintaxe está OK - teste bem-sucedido ‘.

sudo nginx -t

Agora que você criou o bloco de servidor Nginx para o GlassFish, você executará o seguinte comando para iniciar e habilitar o serviço Nginx.

sudo systemctl start nginx  
sudo systemctl enable nginx

O serviço Nginx agora deve estar em execução e habilitado, e será executado automaticamente na inicialização do sistema.

Por fim, verifique o serviço Nginx usando o seguinte para garantir que o serviço esteja em execução.

sudo systemctl status nginx

Você verá a saída como a seguinte - Você pode ver que o serviço Nginx está em execução.

Configurando o Firewalld

O firewalld padrão no Rocky Linux está em execução. Para tornar o GlassFish acessível, você precisará abrir a porta HTTP e a porta de administração do GlassFish 4848.

Execute o seguinte comando firewall-cmd abaixo para adicionar os serviços HTTP e HTTPS e a porta padrão 4848 para a administração do GlassFish.

sudo firewall-cmd --add-service=http --permanent  
sudo firewall-cmd --add-service=https --permanent  
sudo firewall-cmd --add-port=4848/tcp --permanent

Agora recarregue as regras do firewalld e verifique a lista de regras habilitadas via o seguinte comando.

sudo firewall-cmd --reload  
sudo firewall-cmd --list-all

Você deve receber a seguinte saída - Os serviços HTTP e HTTPS foram adicionados ao firewalld e a porta de administração do GlassFish 4848/tcp também foi adicionada.

Acessando o GlassFish

No seu computador local, edite o arquivo ‘/etc/hosts’ usando o seguinte editor nano.

sudo nano /etc/hosts

Adicione a seguinte configuração ao arquivo e certifique-se de alterar o endereço IP do servidor e o nome de domínio local para sua instalação do GlassFIsh.

192.168.5.100  glassfish.howtoforge.local

Salve o arquivo e saia do editor quando terminar.

Em seguida, abra seu navegador da web e visite o nome de domínio da sua instalação do GlassFish (ou seja: http://glassfish.howtoforge.local/). Você deve agora obter a página padrão index.html do GlassFish.

Agora abra uma nova aba e visite seu nome de domínio seguido da porta de administração 4848 (ou seja: https://glassfish.howtoforge.local:4848/). Você deve agora obter a página de login da administração do GlassFish.

Insira o usuário admin e a senha que você configurou e clique em Login.

Se o usuário admin e a senha estiverem corretos, você deve ver o painel de administração do GlassFish como o seguinte.

Conclusão

Neste guia, você instalou o Servidor de Aplicações Java GlassFish em um servidor Rocky Linux. Você também instalou o Java OpenJDK 11 e adicionou um novo arquivo de serviço ao sistema Linux. Por fim, você também aprendeu a instalação e configuração do servidor web Nginx como um proxy reverso para o Servidor de Aplicações Java GlassFish.

Para o próximo passo, você pode agora começar a implantar outras aplicações ou começar a configurar a Alta Disponibilidade do GlassFish.