Cómo instalar el servidor de aplicaciones GlassFish Java con Nginx como proxy inverso en AlmaLinux 9

GlassFish es una implementación gratuita y de código abierto de la plataforma Java EE desarrollada por Eclipse. Es la primera implementación del mundo de la plataforma Java EE para desplegar aplicaciones Java. GlassFish proporciona una arquitectura escalable con el soporte de múltiples tecnologías Java, como Enterprise JavaBeans, JPA, JavaServer Faces y JMS.

Esta guía te mostrará cómo instalar GlassFish en el servidor AlmaLinux 9 con Nginx como proxy inverso. También cubrimos cómo asegurar GlassFish habilitando la autenticación y configurando una conexión segura SSL/TLS para la administración de GlassFish.

Requisitos previos

Antes de comenzar, asegúrate de tener lo siguiente:

• Un servidor AlmaLinux 9.
• Un usuario no root con privilegios de administrador.
• Un nombre de dominio local apuntando a la dirección IP del servidor.

Configuración de dependencias

Primero, necesitas configurar tu sistema AlmaLinux añadiendo un usuario del sistema que se utilizará para ejecutar GlassFish, luego instalar los paquetes de Java OpenJDK.

Antes de instalar cualquier paquete, crea un nuevo usuario del sistema glassfish con el siguiente comando. Este usuario tendrá el directorio home predeterminado /opt/glassfish7, que se utilizará como el directorio de instalación para GlassFish.

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

Ahora instala Java OpenJDK 21 y los paquetes unzip con el siguiente comando. Escribe y para proceder con la instalación.

sudo dnf install java-21-openjdk unzip nano

Una vez que la instalación esté completa, verifica la versión de Java con el siguiente comando. Asegúrate de tener Java 17 o 21 instalado en tu servidor AlmaLinux.

java --version

Descargando el paquete de GlassFish

Después de haber creado un usuario del sistema e instalado Java, ahora puedes descargar el paquete de GlassFish. Asegúrate de visitar la página de descarga de GlassFish y copiar el enlace para la última versión.

Descarga el paquete de GlassFish utilizando el comando wget a continuación.

wget https://download.eclipse.org/ee4j/glassfish/glassfish-7.0.12.zip

Una vez descargado, extrae el archivo glassfish-7.0.12.zip en el directorio /opt con el siguiente comando unzip. Esto extraerá GlassFish en el directorio /opt/glassfish7.

unzip glassfish-7.0.12.zip -d /opt

Por último, cambia la propiedad del directorio /opt/glassfish7 al usuario glassfish. Esto es porque estarás ejecutando GlassFish como un usuario del sistema glassfish.

sudo chown -R glassfish:glassfish /opt/glassfish7

Configuración del servicio systemd para GlassFish

En esta guía, ejecutarás GlassFish como un servicio systemd. Esto ejecutará GlassFish en segundo plano y podrás gestionarlo fácilmente a través de la utilidad systemctl.

Crea un nuevo archivo de servicio systemd /etc/systemd/system/glassfish7.service utilizando el siguiente comando del editor nano.

sudo nano /etc/systemd/system/glassfish7.service

Inserta la configuración de systemd a continuación para GlassFish.

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

Guarda el archivo y cierra el editor cuando termines.

Ahora recarga el gestor de systemd para aplicar tu nuevo archivo de servicio.

sudo systemctl daemon-reload

Luego, inicia y habilita GlassFish con el siguiente comando. Una vez iniciado, GlassFish debería estar funcionando en los puertos 8080 y 4848.

sudo systemctl start glassfish7  
sudo systemctl enable glassfish7

Por último, verifica el servicio glassfish7 con el siguiente comando. Asegúrate de que el servicio glassfish7 esté habilitado y en ejecución en tu sistema.

sudo systemctl status glassfish7

Configuración del administrador de GlassFish

En este punto, GlassFish está funcionando como un servicio systemd en tu sistema. Ahora necesitas confirmar el usuario administrador para GlassFish y configurar enable-secure-admin para asegurar la administración de GlassFish.

Primero, ejecuta el siguiente comando para crear un nuevo usuario administrador para tu instalación de GlassFish.

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

Cuando se te pida el usuario, escribe el usuario predeterminado admin y presiona ENTER cuando se te pida la contraseña. El GlassFish predeterminado viene sin contraseña.
Cuando se te pida configurar una nueva contraseña, escribe tu contraseña y repítela.

Una vez que el proceso esté completo, deberías obtener una salida ‘ Comando change-admin-password ejecutado con éxito ‘.

Después de configurar la contraseña de administrador para GlassFish, ejecuta el siguiente comando para habilitar la función secure-admin. Esto generará automáticamente certificados SSL/TLS para GlassFish.

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

Escribe tu usuario y contraseña de administrador para GlassFish cuando se te pida. Una vez que el proceso sea exitoso, deberías ver una salida ‘ Comando enable-secure-admin ejecutado con éxito ‘.

Por último, reinicia el servicio glassfish7 para aplicar tus modificaciones a tu GlassFish. Después de ejecutar el comando, tu instalación de GlassFish debería estar asegurada, el usuario administrador con nueva contraseña y certificados TLS generados para el administrador de GlassFish.

sudo systemctl restart glassfish7

Ejecutando GlassFish con Nginx como proxy inverso

En esta guía, estarás ejecutando GlassFish detrás del proxy inverso Nginx. Así que ahora necesitas instalar Nginx en tu servidor AlmaLinux, luego crear una nueva configuración de bloque de servidor para el proxy inverso.

Instala el servidor web Nginx en tu AlmaLinux usando el siguiente comando. Escribe y para proceder con la instalación.

sudo dnf install nginx

Después de que la instalación haya finalizado, crea una nueva configuración de bloque de servidor /etc/nginx/conf.d/glassfish.conf utilizando el siguiente comando del editor nano.

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

Inserta la siguiente configuración para establecer un proxy inverso para GlassFish que se ejecuta por defecto en el puerto 8080. Asegúrate de cambiar el nombre de dominio en lo siguiente con tu dominio local.

upstream glassfish7 {  
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://glassfish7/;  
}  
}

Cuando termines, guarda y sal del archivo.

Ahora verifica la sintaxis de Nginx usando el siguiente comando. Si tienes la sintaxis correcta, deberías obtener una salida ‘la sintaxis es correcta - la prueba es exitosa’.

sudo nginx -t

Luego, inicia y habilita Nginx en tu servidor AlmaLinux con el siguiente comando.

sudo systemctl start nginx  
sudo systemctl enable nginx

Una vez iniciado, verifica el servicio Nginx para asegurarte de que el servicio esté en ejecución y habilitado.

sudo systemctl status nginx

A continuación, deberías ver que el servicio Nginx está en ejecución y habilitado en AlmaLinux.

Configuración de Firewalld

Con Nginx en funcionamiento, debes abrir el puerto HTTP en tu servidor a través de firewalld. Además de eso, también puedes abrir el puerto 4848 que es utilizado por el administrador de GlassFish.

Abre ambos servicios HTTP y HTTPS en firewalld con el siguiente comando.

sudo firewall-cmd --add-service={http,https} --permanent

Abre el puerto TCP 4848 que se utilizará para la administración de GlassFish.

sudo firewall-cmd --add-port=4848/tcp --permanent

Ahora recarga firewalld para aplicar tus cambios a firewalld. Luego, verifica las reglas habilitadas.

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

Puedes ver a continuación los servicios HTTP, HTTPS y el puerto 4848 añadidos a firewalld.

Accediendo a GlassFish

Abre tu navegador web y visita tu nombre de dominio para GlassFish, como http://glassfish.howtoforge.local/. Si tu instalación es exitosa, deberías obtener la página de índice de GlassFish como la siguiente.

Ahora abre una nueva pestaña y visita http://glassfish.howtoforge.local:4848/ para acceder a la administración de GlassFish. Escribe el usuario administrador predeterminado con tu contraseña, luego haz clic en Iniciar sesión.

Si tienes la contraseña correcta, deberías ver el panel de control de GlassFish.

Conclusión

¡Felicidades! Ahora has instalado con éxito GlassFish en el servidor AlmaLinux 9. Has instalado GlassFish, configurado el usuario administrador y asegurado el administrador para GlassFish. Por último, también instalaste y configuraste Nginx como un proxy inverso para tu instalación de GlassFish.