Cómo instalar GlassFish Application Server con Nginx Reverse Proxy en Debian 12

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 que proporciona un servidor de aplicaciones ligero y permite desplegar múltiples aplicaciones basadas en Java. GlassFish admite múltiples tipos de tecnologías de aplicaciones Java, como Enterprise JavaBeans, JPA, JavaServer Faces, JMS y muchas más.

GlassFish es una de las mejores opciones para los desarrolladores que desean desarrollar y desplegar aplicaciones basadas en Java. Permite a los desarrolladores crear aplicaciones empresariales de manera conveniente y también con una arquitectura escalable. El proyecto GlassFish fue iniciado originalmente por Sun Microsystem. Viene con dos licencias gratuitas diferentes: la Licencia de Desarrollo y Distribución Común y la Licencia Pública General de GNU.

En esta guía, instalarás GlassFish Application Server en Debian 12 en un proceso paso a paso. También configurarás Nginx como un proxy inverso para tu instalación de GlassFish.

Prerrequisitos

Para comenzar el proceso, asegúrate de tener lo siguiente:

• Un servidor Debian 12 con al menos 4GB de RAM o memoria.
• Un usuario no root con privilegios sudo.

Instalando Java OpenJDK

GlassFish es un servidor de aplicaciones para desplegar aplicaciones Java. Para instalar GlassFish, primero debes instalar Java en tu sistema Debian. En este momento, el repositorio de Debian proporciona Java OpenJDK 17, que es compatible con la última versión de GlassFish.

Primero, actualiza y refresca tu repositorio de Debian usando el siguiente comando.

sudo apt update

Una vez que el repositorio esté actualizado, instala el paquete default-jdk ejecutando el siguiente comando. Al instalar el paquete default-jdk, instalarás Java OpenJDK 17.

sudo apt install default-jdk

Escribe y para continuar con la instalación.

Después de que la instalación haya finalizado, verifica tu versión de Java usando el siguiente comando. Deberías ver que Java OpenJDK 17 está instalado.

java -version

Configurando el Sistema

Después de instalar Java OpenJDK, el siguiente paso es configurar tu sistema Debian instalando paquetes adicionales como wget y unzip, creando un nuevo usuario del sistema glassfish y configurando la variable de entorno JAVA_HOME.

Para comenzar, instalarás el paquete unzip y wget ejecutando el siguiente comando apt.

sudo apt install unzip wget -y

Ahora, ejecuta el siguiente comando para crear un nuevo usuario del sistema glassfish. Este usuario se utilizará para ejecutar tu instalación de GlassFish, que estará ubicada en el directorio /opt/glassfish.

sudo useradd -M -d /opt/glassfish -U -s /bin/false glassfish

A continuación, crea un nuevo script bash /etc/profile.d/java.sh usando el siguiente comando del editor nano.

sudo nano /etc/profile.d/java.sh

Agrega la siguiente configuración para establecer la variable de entorno JAVA_HOME y agregar la ruta bin de Java al PATH del sistema.

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64  
export PATH=$PATH:$JAVA_HOME/bin

Guarda y cierra el archivo cuando termines.

Ahora carga la nueva variable de entorno dentro de /etc/profile.d/java.sh usando el comando source a continuación.

source /etc/profile.d/java.sh

Por último, ejecuta el siguiente comando para verificar las variables de entorno PATH y JAVA_HOME del sistema.

echo $JAVA_HOME  
echo $PATH

Si todo va bien, deberías ver que la ruta JAVA_HOME está configurada al directorio /usr/lib/jvm/java-17-openjdk-amd64, y el directorio bin de Java se ha agregado al PATH del sistema.

Descargando el Paquete Binario de GlassFish

Con Java OpenJDK instalado y tu sistema Debian listo, ahora puedes descargar e instalar GlassFish. Antes de continuar, consulta la página de descarga de GlassFish para obtener la última versión de GlassFish. En este momento, la última versión de GlassFish es v7.0.10.

Ve al directorio /tmp y descarga el paquete binario de GlassFish a través del comando wget a continuación. Una vez que el proceso de descarga haya finalizado, deberías ver el archivo glassfish-7.0.10.zip.

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

Extrae el archivo glassfish-7.0.10.zip al directorio /opt a través del comando unzip a continuación. El paquete de GlassFish se extraerá al directorio /opt/glassfish7.

unzip glassfish-7.0.10.zip -d /opt

Por último, renombra el directorio extraído de /opt/glassfish7 a /opt/glassfish. Luego, cambia la propiedad del directorio /opt/glassfish al usuario glassfish.

mv /opt/glassfish7 /opt/glassfish  
sudo chown -R glassfish:glassfish /opt/glassfish

Ejecutando GlassFish como un Servicio Systemd

Después de descargar el paquete binario de GlassFish, crearás un nuevo archivo de servicio systemd que se utilizará para ejecutar GlassFish. Esto te permitirá gestionar GlassFish a través de la utilidad systemctl y ejecutar GlassFish en segundo plano como un servicio systemd.

Para ejecutar GlassFish como un servicio systemd, ejecuta el siguiente comando del editor nano para crear un nuevo archivo /etc/systemd/system/glassfish.service.

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

Inserta la siguiente configuración en el archivo.

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

Guarda y cierra el archivo cuando termines.

Ahora, ejecuta el siguiente comando systemctl para recargar el gestor systemd y aplicar los cambios.

sudo systemctl daemon-reload

Con el gestor systemd recargado, inicia y habilita el servicio glassfish usando el siguiente comando.

sudo systemctl start glassfish  
sudo systemctl enable glassfish

Por último, verifica el estado del servicio glassfish usando el siguiente comando.

sudo systemctl status glassfish

Si todo va bien, deberías ver que el estado de glassfish es activo (en ejecución), y está habilitado.

Configurando Usuario y Asegurando la Administración de GlassFish

En este punto, GlassFish está en funcionamiento. Ahora configurarás la instalación de GlassFish cambiando la contraseña predeterminada para la Consola de Administración y habilitando el Administrador Seguro. Esto se puede hacer a través del comando asadmin que está disponible en el directorio /opt/glassfish/bin.

Ejecuta la línea de comando asadmin a continuación para cambiar la contraseña de administrador para tu instalación de GlassFish.

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

Durante el proceso, se te pedirá lo siguiente:

• Ingresa el usuario administrador predeterminado para GlassFish.
• Presiona ENTER cuando se te pida la contraseña. El usuario administrador predeterminado para GlassFish no tiene contraseña.
• Ahora ingresa la nueva contraseña de administrador para GlassFish y repite.

Cuando el proceso esté completo, deberías recibir un mensaje como el siguiente:

A continuación, ejecuta el comando asadmin a continuación para habilitar el administrador seguro en tu instalación de GlassFish.

Esencialmente, el Administrador Seguro habilita comunicaciones seguras a través de SSL entre el servidor de administración de dominio (DAS), instancias remotas y clientes de administración, incluyendo la utilidad asadmin, la consola de administración y clientes REST.

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

Ingresa tu usuario y contraseña de administrador de GlassFish, luego presiona Enter. Cuando termines, se mostrará la siguiente salida.

Después de habilitar el administrador seguro, ejecuta el siguiente comando para reiniciar el servicio glassfish y aplicar los cambios.

sudo systemctl restart glassfish

Ahora, abre tu navegador web y visita la dirección IP del servidor seguida del puerto 8080, como http://192.168.5.15:8080/. Si tu instalación de GlassFish es exitosa, deberías ver la siguiente página, que confirma que GlassFish está en funcionamiento.

Por último, abre una nueva pestaña y visita la misma dirección IP del servidor con el puerto 4848 (es decir: https://192.168.5.15:4848/) para acceder a la página de administración de GlassFish. Acepta los certificados SSL/TLS en tu navegador web, y si es exitoso, deberías ver la página de inicio de sesión de administración de GlassFish a continuación.

Instalando Nginx como Proxy Inverso

En esta guía, ejecutarás GlassFish con Nginx como un proxy inverso. Ahora, instalarás Nginx en tu máquina Debian y crearás una nueva configuración de bloque de servidor para GlassFish. En este caso, utilizaremos un nombre de dominio local glassfish.howtoforge.local.

Primero, instala Nginx en tu sistema Debian usando el siguiente comando apt. Ingresa y para continuar con la instalación.

sudo apt install nginx

Después de que Nginx esté instalado, crea una nueva configuración de bloque de servidor /etc/nginx/sites-available/glassfish usando el siguiente comando del editor nano.

sudo nano /etc/nginx/sites-available/glassfish

Inserta la siguiente configuración y asegúrate de cambiar el parámetro server_name con tu nombre de dominio local.

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

Guarda y sal del archivo cuando termines.

A continuación, ejecuta el siguiente comando para activar la configuración del bloque de servidor glassfish y verificar la sintaxis de Nginx para asegurarte de que tienes la sintaxis correcta.

sudo ln -s /etc/nginx/sites-available/glassfish /etc/nginx/sites-enabled/  
sudo nginx -t

Si tienes la sintaxis correcta de Nginx, deberías obtener la salida ‘test is successful - syntax is ok‘.

Ahora puedes reiniciar el servicio Nginx y aplicar los cambios. Luego, verifica el servicio Nginx para asegurarte de que el servicio esté en funcionamiento.

sudo systemctl restart nginx  
sudo systemctl status nginx

En la salida siguiente, deberías ver que el servicio Nginx está en funcionamiento.

Accediendo a la Instalación de GlassFish

En la última sección, accederás a tu instalación de GlassFish desde la máquina cliente. Puedes usar cualquier sistema operativo como tu máquina cliente.

Edita el archivo /etc/hosts en tu máquina local e inserta la siguiente configuración. Asegúrate de cambiar la dirección IP del servidor y el nombre de dominio local. Si estás usando un cliente Windows, asegúrate de modificar el archivo C:\Windows\System32\drivers\etc\hosts como administrador.

192.168.5.15    glassfish.howtoforge.local

Ahora vuelve a tu navegador web y visita el nombre de dominio de tu instalación de GlassFish, como http://glassfish.howtoforge.local/. Si tu configuración de proxy inverso de Nginx es exitosa, deberías ver la página de índice predeterminada de GlassFish como la siguiente.

A continuación, visita la página de administración de GlassFish dentro del puerto 4848 (es decir: https://glassfish.howtoforge.local:4848/). En la página de inicio de sesión, ingresa tu usuario y contraseña de administrador, luego haz clic en Iniciar sesión.

Si tu instalación es exitosa, deberías obtener el panel de administración de GlassFish como el siguiente:

Ahora haz clic en el menú Servidor para verificar el estado de tu instalación de GlassFish. En este ejemplo, deberías ver que GlassFish 7.0 está instalado con el estado En ejecución.

Desde aquí, ahora puedes gestionar tu servidor de aplicaciones GlassFish.

Conclusión

En conclusión, ahora has instalado con éxito el GlassFish Application Server en un servidor Debian 12, siguiendo las instrucciones paso a paso. Has instalado GlassFish con Java OpenJDK 17 y Nginx como proxy inverso, y también has asegurado GlassFish cambiando la contraseña de administrador predeterminada y habilitando el Administrador Seguro. Ahora puedes comenzar a desplegar tu aplicación con GlassFish.